Homelable: Instalacja, Konfiguracja i Obsługa — Kompletny Przewodnik po Wizualizatorze Infrastruktury Homelab (2026)

    Daniel Nowak·
    Administracja systemamiFelietonhomelabmonitoringproxmoxserwer

    Homelable to samodzielnie hostowane (self-hosted) narzędzie do wizualizacji infrastruktury homelabowej, które w formie interaktywnego diagramu sieci pokazuje wszystkie urządzenia, maszyny wirtualne, kontenery i usługi działające w Twojej domowej lub firmowej sieci. Projekt, rozwijany przez Pouzor na GitHubie (github.com/Pouzor/homelable), zdobył już ponad 2,5 tysiąca gwiazdek i jest jednym z najczęściej wybieranych narzędzi typu „network topology mapper” w społeczności self-hosted/homelab.

    W tym artykule krok po kroku pokażemy, jak zainstalować Homelable (Docker, Docker Compose, Proxmox LXC, build ze źródeł), jak go skonfigurować przez plik .env, oraz jak korzystać z jego najważniejszych funkcji: skanera sieci, importu Proxmox, Zigbee/Z-Wave, monitoringu na żywo oraz serwera MCP dla asystentów AI.


    Promocja na kursy n8n i AI dla Administratora
    Naucz się automatyzować powtarzalne zadania, integrować systemy, tworzyć workflow z AI oraz budować agentów i rozwiązania RAG.
    Sprawdź szczegóły:
     
     
     

    Spis treści

    1. Czym jest Homelable?
    2. Najważniejsze funkcje Homelable
    3. Wymagania wstępne
    4. Instalacja Homelable
      • Metoda 1: Szybka instalacja skryptem (Docker)
      • Metoda 2: Instalacja standalone (tylko frontend)
      • Metoda 3: Docker Compose z repozytorium Git
      • Metoda 4: Proxmox VE (community-scripts / LXC)
      • Metoda 5: Instalacja z kodu źródłowego (backend + frontend)
      • Metoda 6: Integracja z Home Assistant (HACS)
    5. Pierwsze uruchomienie i logowanie
    6. Konfiguracja Homelable (.env)
    7. Obsługa Homelable — funkcje krok po kroku
      • Skaner sieci (Network Scanner)
      • Import z Proxmox VE
      • Import Zigbee (Zigbee2MQTT)
      • Import Z-Wave (zwavejs2mqtt)
      • Monitoring statusu (Live View)
      • Kreator diagramu, motywy i eksport PNG/SVG
      • Serwer MCP dla asystentów AI
      • API statystyk dla Homepage/Gethomepage
    8. Bezpieczeństwo i dobre praktyki
    9. Najczęstsze problemy (Troubleshooting)
    10. FAQ — Najczęściej zadawane pytania
    11. Podsumowanie

    1. Czym jest Homelable?

    Homelable to open-source’owe, samodzielnie hostowane rozwiązanie do wizualizacji infrastruktury sieciowej. W przeciwieństwie do klasycznych narzędzi monitoringu (Grafana, Zabbix, Uptime Kuma), Homelable stawia na warstwę wizualną: zamiast tabel i wykresów otrzymujemy interaktywny diagram (canvas), na którym każde urządzenie — router, switch, serwer, NAS, VM, kontener LXC, punkt dostępowy czy czujnik IoT — jest osobnym, edytowalnym węzłem połączonym odpowiednim typem krawędzi (Ethernet, Wi-Fi, IoT, VLAN, wirtualna).

    Aplikacja łączy trzy warstwy działania:

    • Odkrywanie — automatyczne skanowanie sieci (nmap) oraz import z Proxmox, Zigbee2MQTT i zwavejs2mqtt.
    • Wizualizacja — swobodne rozmieszczanie węzłów na kanwie, rzuty kondygnacji (floor plans), wiele kanw (multi-canvas), gotowe motywy graficzne.
    • Monitorowanie — cykliczne health-checki (ping/TCP, zapytania HTTP /health itd.) pokazujące status online/offline/unknown bezpośrednio na diagramie.

    Projekt jest w pełni open source, dystrybuowany jako obraz Docker, a jego kod źródłowy jest publicznie dostępny na GitHubie pod adresem github.com/Pouzor/homelable.

    2. Najważniejsze funkcje Homelable

    Zanim przejdziemy do instalacji, warto poznać pełen zakres możliwości Homelable:

    • Skaner sieci – uruchamia nmap -sV --open na skonfigurowanych zakresach CIDR i buduje kolejkę urządzeń oczekujących na zatwierdzenie.
    • Import Proxmox VE – pobiera hosty, maszyny wirtualne i kontenery LXC przez REST API Proxmoksa wraz ze stanem działania i parametrami sprzętowymi, z opcją automatycznej, cyklicznej synchronizacji.
    • Import Zigbee2MQTT – odczytuje topologię sieci Zigbee z brokera MQTT i dodaje koordynator, routery oraz urządzenia końcowe jako typowane węzły.
    • Import Z-Wave (zwavejs2mqtt) – analogicznie do Zigbee, z automatycznym wyznaczaniem hierarchii kontroler → routery → urządzenia końcowe na podstawie listy sąsiadów.
    • 11 typów węzłów (router, switch, serwer, Proxmox, VM, LXC, NAS, IoT, access point i inne) oraz 5 typów połączeń (Ethernet, Wi-Fi, IoT, VLAN, wirtualne).
    • Monitoring na żywo – niezależna metoda sprawdzania statusu dla każdego węzła (ping/TCP, endpoint /health itp.), z automatycznym odświeżaniem.
    • Rzuty kondygnacji i wiele kanw (multi-canvas) – możliwość rozmieszczenia urządzeń na planie mieszkania/domu oraz tworzenia osobnych diagramów dla różnych lokalizacji lub sieci.
    • Personalizacja i motywy – gotowe style graficzne lub pełna personalizacja wyglądu każdego urządzenia; eksport diagramu do PNG/SVG.
    • Tryb samego frontendu (standalone) – jeśli zależy Ci wyłącznie na warstwie graficznej, możesz uruchomić sam frontend bez backendu i skanera.
    • Serwer MCP (Model Context Protocol) – umożliwia asystentom AI odpytywanie i wykorzystywanie danych o infrastrukturze bezpośrednio z Homelable.
    • Integracja z Home Assistant przez HACS – oficjalny dodatek homelable-hacs wystawia encje sensor/binary_sensor dla każdego węzła oraz usługi typu homelable.scan_now.
    • API statystyk dla dashboardów typu gethomepage (widget customapi).

    3. Wymagania wstępne

    Do uruchomienia Homelable w wersji produkcyjnej (self-hosted, pełna funkcjonalność) potrzebujesz:

    • Docker oraz Docker Compose (zalecana metoda instalacji).
    • Dostępu do powłoki (SSH/terminal) na hoście, na którym uruchomisz kontener.
    • Opcjonalnie: uprawnień root/CAP_NET_RAW dla kontenera, jeśli chcesz pełnej dokładności skanera (ICMP ping, odczyt ARP) — bez nich skaner i tak działa, ale w trybie zdegradowanym (czysty skan TCP connect).
    • Do funkcji importu: dostęp do API Proxmox VE, działającego brokera MQTT (dla Zigbee2MQTT/zwavejs2mqtt) lub konta Home Assistant (dla integracji HACS).
    • Do wersji „build from source”: Python 3.13 oraz środowisko Node.js dla frontendu.

    4. Instalacja Homelable

    Homelable oferuje kilka ścieżek instalacji — dopasowanych zarówno do początkujących (jedna komenda), jak i zaawansowanych administratorów (build ze źródeł, integracja z Proxmox VE czy Home Assistant).

    Metoda 1: Szybka instalacja skryptem (Docker)

    Najprostszy sposób uruchomienia pełnej wersji (backend + frontend + skaner) to oficjalny skrypt instalacyjny:

    curl -fsSL https://raw.githubusercontent.com/Pouzor/homelable/main/install.sh | bash
cd homelable && docker compose up -d

    Skrypt pobiera gotowy docker-compose.yml, tworzy katalog roboczy i uruchamia kontenery. Ten sam skrypt służy również do aktualizacji — wystarczy uruchomić go ponownie, a wykryje istniejącą instalację i zaktualizuje jedynie plik docker-compose.yml:

    curl -fsSL https://raw.githubusercontent.com/Pouzor/homelable/main/install.sh | bash
cd homelable && docker compose pull && docker compose up -d

    Metoda 2: Instalacja standalone (tylko frontend)

    Jeśli zależy Ci wyłącznie na warstwie wizualnej — np. chcesz zaprojektować diagram i wyeksportować go jako PNG, bez skanera i backendu — użyj flagi --standalone:

    curl -fsSL https://raw.githubusercontent.com/Pouzor/homelable/main/install.sh | bash -s -- --standalone
cd homelable && docker compose up -d

    Metoda 3: Docker Compose z repozytorium Git

    Alternatywnie możesz sklonować repozytorium ręcznie i samodzielnie przygotować plik .env przed pierwszym uruchomieniem:

    git clone https://github.com/Pouzor/homelable.git
cd homelable
cp .env.example .env
docker compose up -d

    Ta metoda daje pełną kontrolę nad konfiguracją jeszcze przed startem kontenerów — warto z niej skorzystać, jeśli od razu chcesz ustawić np. hasło administratora lub zakresy skanowania.

    Metoda 4: Proxmox VE (community-scripts / LXC)

    Dla użytkowników Proxmoksa dostępny jest gotowy skrypt tworzący dedykowany kontener LXC z Homelable, przygotowany we współpracy z community-scripts:

    bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/homelable.sh)"

    To rozwiązanie jest wygodne, gdy chcesz odizolować Homelable w osobnym, lekkim kontenerze LXC zarządzanym bezpośrednio z poziomu konsoli Proxmox VE, bez ręcznej konfiguracji Dockera.

    Metoda 5: Instalacja z kodu źródłowego (backend + frontend)

    Dla deweloperów i osób chcących modyfikować kod, Homelable można uruchomić bezpośrednio z repozytorium, bez Dockera. Backend wymaga Pythona 3.13:

    cd backend
python3.13 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp ../.env.example .env   # edytuj SECRET_KEY i przejrzyj wartości domyślne
uvicorn app.main:app --reload --port 8000

    Frontend uruchamia się analogicznie w osobnym terminalu (zgodnie ze wskazówkami w INSTALLATION.md repozytorium) — ta metoda jest zalecana głównie do developmentu i testowania nowych funkcji przed wdrożeniem produkcyjnym.

    Metoda 6: Integracja z Home Assistant (HACS)

    Jeśli korzystasz z Home Assistant, możesz zainstalować oficjalny dodatek homelable-hacs, który osadza panel Homelable bezpośrednio w interfejsie HA:

    1. Przejdź do HACS → Integracje → ⋮ → Custom repositories.
    2. Dodaj https://github.com/Pouzor/homelable-hacs jako repozytorium typu Integration.
    3. Zainstaluj Homelable i uruchom ponownie Home Assistant.
    4. Przejdź do Ustawienia → Urządzenia i usługi → Dodaj integrację i wyszukaj „Homelable”.

    Wymagania: Home Assistant 2024.1 lub nowszy oraz dostępny nmap na hoście. Integracja tworzy sensor.homelable_<id> i binary_sensor.homelable_<id>_online dla każdego węzła na kanwie, a także usługi takie jak homelable.scan_now, homelable.approve_device czy homelable.refresh_status.

    5. Pierwsze uruchomienie i logowanie

    Po uruchomieniu kontenerów (dowolną z metod Docker) otwórz w przeglądarce:

    http://adres_ip_serwera:3000

    Domyślne dane logowania to:

    • Login: admin
    • Hasło: admin

    Ważne: zanim wystawisz Homelable poza sieć lokalną (np. przez reverse proxy, VPN lub port forwarding), koniecznie zmień domyślne dane logowania w pliku .env (AUTH_USERNAME / AUTH_PASSWORD_HASH). Pozostawienie domyślnego hasła admin/admin na usłudze dostępnej z internetu to poważne ryzyko bezpieczeństwa.

    Po pierwszym zalogowaniu aplikacja automatycznie wykrywa pustą kanwę i uruchamia krótki kreator „Getting Started”, prowadzący przez pierwsze kroki: dodanie węzła, uruchomienie skanu sieci i zapisanie diagramu.

    6. Konfiguracja Homelable (.env)

    Cała konfiguracja Homelable odbywa się przez plik .env, tworzony na bazie .env.example. Poniżej najważniejsze zmienne środowiskowe:

    # Klucz sesji/szyfrowania — koniecznie zmień w produkcji
SECRET_KEY=change_me_in_production

# Dane logowania — domyślnie: admin / admin
AUTH_USERNAME=admin
AUTH_PASSWORD_HASH='$2b$12$...'   # hash bcrypt — zachowaj pojedyncze cudzysłowy

# Zakresy CIDR do skanowania siecią
SCANNER_RANGES=["192.168.1.0/24"]

# Częstotliwość sprawdzania statusu węzłów (w sekundach)
STATUS_CHECKER_INTERVAL=60

# Integracja z Proxmox VE (opcjonalnie)
PROXMOX_TOKEN_ID=root@pam!homelable
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
PROXMOX_HOST=192.168.1.10
PROXMOX_PORT=8006
PROXMOX_VERIFY_TLS=true          # ustaw false tylko dla certyfikatów self-signed

# Automatyczna synchronizacja Zigbee2MQTT (opcjonalnie)
ZIGBEE_MQTT_HOST=192.168.1.20
ZIGBEE_MQTT_PORT=1883
ZIGBEE_MQTT_USERNAME=mqttuser        # opcjonalnie
ZIGBEE_MQTT_PASSWORD=mqttpass        # opcjonalnie
ZIGBEE_BASE_TOPIC=zigbee2mqtt
ZIGBEE_MQTT_TLS=false                # true dla brokerów z TLS (zwykle port 8883)
ZIGBEE_MQTT_TLS_INSECURE=false       # pomiń weryfikację certyfikatu (tylko self-signed; wymaga TLS)

    Kilka istotnych uwag dotyczących konfiguracji:

    • SCANNER_RANGES i STATUS_CHECKER_INTERVAL można też edytować bez restartu kontenera bezpośrednio w aplikacji, przez przycisk „Scan Network” w panelu bocznym.
    • Dane MQTT (Zigbee/Z-Wave) służą wyłącznie do automatycznej, cyklicznej synchronizacji (Settings → Zigbee auto-sync / /sync-now) — nie są zapisywane na dysku ani zwracane przez żadne API. Jednorazowe importy przez okno dialogowe działają niezależnie i nie wymagają tych zmiennych.
    • Po zmianie danych integracji z Proxmox lub Zigbee zaleca się restart backendu: docker compose restart backend.

    7. Obsługa Homelable — funkcje krok po kroku

    Skaner sieci (Network Scanner)

    Skaner to podstawowa funkcja Homelable pozwalająca błyskawicznie zmapować urządzenia w sieci lokalnej:

    1. Otwórz panel boczny i kliknij „Scan Network”.
    2. Ustaw zakresy CIDR (jeśli nie skonfigurowano ich w .env).
    3. Uruchom skan — silnik wykonuje nmap -sV --open, wykrywając otwarte porty i usługi.
    4. Wykryte urządzenia trafiają do kolejki Device Inventory.
    5. Dla każdego urządzenia możesz wybrać: zatwierdź (dodaje węzeł do kanwy), ukryj lub zignoruj.

    Skaner działa nawet bez podwyższonych uprawnień — wykorzystuje wtedy ping sweep, odczyt tablicy ARP, czysty skan TCP connect w Pythonie oraz mDNS/zeroconf. Dostęp do surowych socketów (raw socket) pozwala na dokładniejsze wykrywanie hostów i adresów MAC, ale nie jest wymagany do działania.

    Import z Proxmox VE

    Homelable potrafi zaimportować całą infrastrukturę Proxmox VE — hosty, maszyny wirtualne i kontenery LXC — jako gotowe, typowane węzły wraz ze stanem działania i parametrami sprzętowymi:

    1. Utwórz w Proxmoksie token API z uprawnieniami tylko do odczytu.
    2. Uzupełnij dane PROXMOX_HOST, PROXMOX_TOKEN_ID i PROXMOX_TOKEN_SECRET w .env (lub bezpośrednio w aplikacji).
    3. Kliknij „Import from Proxmox” w panelu bocznym.
    4. Wybierz węzły do dodania — mogą zostać ustawione na automatyczną, cykliczną synchronizację.

    Jeśli dany host/VM został wcześniej wykryty przez skaner sieci (po adresie IP), Homelable automatycznie scala wpisy zamiast tworzyć duplikaty.

    Import Zigbee (Zigbee2MQTT)

    Aby zaimportować topologię sieci Zigbee:

    1. Upewnij się, że masz działający broker MQTT (np. Mosquitto) dostępny z hosta Homelable oraz Zigbee2MQTT podłączony do tego brokera z co najmniej jednym sparowanym urządzeniem.
    2. Kliknij „Zigbee Import” w panelu bocznym (poniżej „Scan Network”).
    3. Podaj host i port brokera (domyślnie 1883), opcjonalne dane logowania oraz bazowy topic (domyślnie zigbee2mqtt).
    4. Kliknij „Test Connection”, a następnie „Fetch Devices”.
    5. Zaznacz interesujące Cię urządzenia z pogrupowanej listy (Koordynator / Router / Urządzenie końcowe) i kliknij „Add N to Canvas” — urządzenia trafiają na siatkę z odpowiednimi krawędziami typu IoT.

    Import Z-Wave (zwavejs2mqtt)

    Import Z-Wave działa analogicznie do Zigbee, poprzez broker MQTT połączony z zwavejs2mqtt:

    1. Kliknij „Z-Wave Import” w panelu bocznym (poniżej „Zigbee Import”).
    2. Podaj host i port brokera (domyślnie 1883), prefiks MQTT (domyślnie zwave) oraz nazwę bramki (domyślnie zwavejs2mqtt).
    3. Wybierz urządzenia z listy (Kontroler / Router / Urządzenie końcowe) i kliknij „Add N to Canvas”.

    Hierarchia węzłów (kontroler → routery → urządzenia końcowe) jest wyznaczana automatycznie na podstawie listy sąsiadów każdego węzła. W sieci Z-Wave nie występuje parametr LQI (Link Quality Indicator), więc jest on pomijany w porównaniu do Zigbee.

    Monitoring statusu (Live View)

    Homelable w sposób ciągły monitoruje status każdego węzła na kanwie i wyświetla go bezpośrednio na diagramie jako online, offline lub unknown. Każdy węzeł można skonfigurować z niezależną metodą sprawdzania, dopasowaną do rodzaju usługi:

    • ping/TCP dla urządzeń sieciowych,
    • zapytanie do endpointu /health dla aplikacji webowych,
    • inne metody health-check w zależności od typu węzła.

    Częstotliwość odświeżania kontroluje zmienna STATUS_CHECKER_INTERVAL w .env (domyślnie 60 sekund).

    Kreator diagramu, motywy i eksport PNG/SVG

    Poza warstwą funkcjonalną Homelable oferuje rozbudowaną personalizację wyglądu:

    • gotowe motywy graficzne (style) do wyboru dla całej kanwy,
    • możliwość indywidualnego dostosowania wyglądu każdego urządzenia z osobna,
    • obsługę rzutów kondygnacji (floor plans) — umieszczanie urządzeń na planie pomieszczeń,
    • wiele kanw (multi-canvas) — osobne diagramy dla różnych lokalizacji lub podsieci,
    • eksport diagramu do plików PNG lub SVG — przydatny do dokumentacji lub prezentacji infrastruktury.

    Tryb standalone (opisany w sekcji instalacji) pozwala korzystać z tej warstwy wizualnej całkowicie niezależnie od skanera i backendu, jeśli zależy Ci wyłącznie na estetycznym diagramie.

    Serwer MCP dla asystentów AI

    Homelable udostępnia wbudowany serwer MCP (Model Context Protocol), dzięki któremu asystenci AI (np. zintegrowani z Claude, Home Assistant czy innym klientem MCP) mogą odpytywać dane o infrastrukturze — listę węzłów, ich status, typ czy relacje — i wykorzystywać je w rozmowie lub automatyzacjach, bez konieczności ręcznego kopiowania danych z panelu. To czyni Homelable jednym z niewielu open-source’owych narzędzi homelabowych z natywnym wsparciem dla warstwy agentowej AI.

    API statystyk dla Homepage/Gethomepage

    Homelable może wystawiać niewielki endpoint JSON ze statystykami, który konsumuje popularny dashboard gethomepage przez wbudowany widget customapi. Funkcja jest domyślnie wyłączona:

    1. Włącz odpowiednią opcję w konfiguracji i zrestartuj backend: docker compose restart backend.
    2. Wyślij zapytanie do GET /api/v1/stats/summary, dołączając nagłówek X-API-Key: twoj-tajny-klucz.

    8. Bezpieczeństwo i dobre praktyki

    • Zawsze zmień domyślne hasło (admin/admin) przed udostępnieniem Homelable poza siecią lokalną.
    • Ustaw unikalny, losowy SECRET_KEY — nigdy nie zostawiaj wartości change_me_in_production.
    • Do integracji z Proxmox VE używaj tokenu API z uprawnieniami tylko do odczytu.
    • Jeśli wystawiasz Homelable do internetu, rób to przez reverse proxy z TLS (np. Traefik, Nginx Proxy Manager) i rozważ dodatkową warstwę uwierzytelniania (np. Authelia) lub dostęp wyłącznie przez VPN.
    • Dla brokerów MQTT z certyfikatem self-signed używaj ZIGBEE_MQTT_TLS_INSECURE=true wyłącznie w sieciach zaufanych — nigdy w środowisku produkcyjnym eksponowanym publicznie.
    • Regularnie aktualizuj Homelable, uruchamiając ponownie skrypt instalacyjny (docker compose pull && docker compose up -d) — kolejne wydania regularnie usuwają luki bezpieczeństwa we frontendzie (np. czyszczenie alertów Dependabot).

    9. Najczęstsze problemy (Troubleshooting)

    • Skaner nie wykrywa urządzeń / niepełne wyniki MAC-adresów — kontener działa bez uprawnień raw socket. Nadaj kontenerowi CAP_NET_RAW/CAP_NET_ADMIN lub uruchom go z podwyższonymi uprawnieniami, aby uzyskać pełny ping ICMP i odczyt ARP.
    • Nie mogę się zalogować po zmianie hasła — upewnij się, że AUTH_PASSWORD_HASH jest poprawnym hashem bcrypt i że cała wartość jest otoczona pojedynczymi cudzysłowami w pliku .env (znaki $ mogą być błędnie interpretowane przez powłokę bez cudzysłowów).
    • Import Zigbee/Z-Wave kończy się błędem połączenia — sprawdź, czy broker MQTT jest osiągalny z hosta Homelable (a nie tylko z hosta Zigbee2MQTT/zwavejs2mqtt), oraz czy port i dane logowania są poprawne. Użyj przycisku „Test Connection” przed pobraniem urządzeń.
    • Duplikaty węzłów po imporcie Proxmox — Homelable scala węzły automatycznie na podstawie adresu IP; jeśli duplikaty nadal występują, sprawdź, czy adresy IP gościa nie zmieniły się od czasu ostatniego skanu sieci.
    • Zmiany w .env nie są widoczne — większość zmiennych wymaga restartu kontenera backendu (docker compose restart backend), część ustawień (np. zakresy skanera) można natomiast zmienić bezpośrednio w interfejsie bez restartu.

    10. FAQ — Najczęściej zadawane pytania

    Czy Homelable jest darmowy?

    Tak, Homelable to projekt open source, dostępny bezpłatnie na GitHubie i uruchamiany we własnej infrastrukturze (self-hosted).

    Czy Homelable wymaga Proxmoksa, Zigbee lub Home Assistant?

    Nie. Wszystkie integracje (Proxmox, Zigbee2MQTT, zwavejs2mqtt, Home Assistant/HACS) są opcjonalne. Podstawowa funkcjonalność — skaner sieci i ręczne budowanie diagramu — działa niezależnie od nich.

    Czy mogę używać Homelable tylko do rysowania diagramu, bez skanowania sieci?

    Tak — służy do tego tryb standalone, uruchamiany flagą --standalone podczas instalacji, w którym działa wyłącznie frontend.

    Jakie są domyślne dane logowania?

    Domyślnie login i hasło to admin / admin. Należy je koniecznie zmienić przed wystawieniem usługi poza sieć lokalną.

    Czy Homelable łączy urządzenia automatycznie liniami na diagramie?

    Nie w pełni — skaner sieci nazywa i lokalizuje wykryte urządzenia, ale to użytkownik decyduje, jak połączyć je krawędziami (Ethernet, Wi-Fi, IoT, VLAN, wirtualne) na kanwie.

    Czy Homelable działa z Home Assistant?

    Tak, poprzez oficjalny dodatek HACS homelable-hacs, który wystawia encje sensor/binary_sensor oraz usługi takie jak homelable.scan_now bezpośrednio w Home Assistant.

    Czy Homelable obsługuje asystentów AI?

    Tak — wbudowany serwer MCP (Model Context Protocol) pozwala asystentom AI odpytywać dane o infrastrukturze zmapowanej w Homelable.

    11. Podsumowanie

    Homelable to kompletne, samodzielnie hostowane narzędzie do mapowania, wizualizacji i monitorowania infrastruktury homelabowej — od jednorazowego skanu sieci, przez automatyczny import z Proxmoksa, Zigbee i Z-Wave, aż po monitoring statusu w czasie rzeczywistym i integrację z Home Assistant oraz asystentami AI przez serwer MCP. Instalacja sprowadza się do jednej komendy Dockera, a cała konfiguracja odbywa się przez czytelny plik .env lub bezpośrednio w interfejsie aplikacji.

    Jeśli szukasz narzędzia, które w kilka minut zamieni chaotyczną listę adresów IP w czytelny, interaktywny diagram Twojej sieci — Homelable jest jedną z najlepszych obecnie dostępnych opcji open source w tej kategorii.

    Źródło i dokumentacja: github.com/Pouzor/homelable

     

    Promocja na kursy n8n i AI dla Administratora

    Naucz się automatyzować powtarzalne zadania, integrować systemy, tworzyć workflow z AI oraz budować agentów i rozwiązania RAG.
    Sprawdź szczegóły:
     
     
     

    Promocja na kursy n8n i AI dla Administratora

    Dołącz!
    X