🏠 Homelable
Homelable Gids: Installatie en Functionaliteiten Welkom bij de complete handleiding voor het installeren en configureren van Homelable binnen je Proxmox VE-omgeving. Homelable is een interactieve tool voor netwerkvisualisatie en monitoring. Hiermee breng je jouw homelab-infrastructuur visueel in kaart op een drag-and-drop canvas, inclusief live statuscontroles en hardwarespecificaties.
🚀 Installatie via Proxmox Helper-Scripts
De snelste en meest betrouwbare manier om Homelable te installeren op Proxmox VE is via de officiële Proxmox community helper-scripts. Dit script maakt automatisch een geoptimaliseerde Linux Container (LXC) voor je aan.
Stappenplan installatie:
Log in op de Proxmox VE Web UI.
Selecteer in het linkermenu de Proxmox Host (de hoofdnode).
Open de Shell van de host.
Kopieer en plak het onderstaande commando in de shell en druk op Enter:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/homelable.sh)"
/root/change_password.sh.
🗺️ Mogelijkheden van Homelable Homelable biedt een breed scala aan functies om het beheer en de monitoring van je thuisnetwerk te vereenvoudigen: Drag-and-Drop Canvas: Ontwerp visueel je eigen netwerktopologie door nodes, switches, servers en clients naar de juiste plek te slepen. Live Status Checks: Real-time monitoring van je netwerkapparaten via verschillende protocollen: Ping: Basis bereikbaarheidscontrole. HTTP/HTTPS: Controleren of webapplicaties online zijn. TCP: Specifieke poortcontroles. SSH: Verbindingsstatus voor servers. Hardware Spec Tracking: Houd systeembronnen en hardwarespecificaties van je aangesloten apparaten overzichtelijk bij.
🔍 Netwerk Scan-optie (Nmap-integratie)
Homelable beschikt over een ingebouwde scanfunctie die aangedreven wordt door Nmap. Hiermee kun je automatisch je lokale netwerk scannen om nieuwe apparaten te ontdekken zonder ze handmatig te hoeven invoeren.
Hoe te gebruiken:
Navigeer binnen Homelable naar het Scan-menu of de netwerkontdekkingstool.
Geef het gewenste IP-bereik op (bijvoorbeeld 192.168.1.0/24).
Start de scan. Gevonden apparaten worden direct getoond en kunnen met één klik aan je visuele canvas worden toegevoegd.
🔌 Proxmox Host Implementatie via API Token
Om de status en specificaties van je Proxmox host(s) en bijbehorende virtuele machines (VM's) of containers (LXC's) automatisch live in Homelable te tonen, koppel je de systemen veilig via een Proxmox API Token.
Stap 1: API Token aanmaken in Proxmox
Ga in Proxmox VE naar Datacenter -> Permissions -> API Tokens.
Klik op Add en kies een gebruiker (bijv. root of een speciaal aangemaakte monitoring-user).
Geef de token een herkenbare naam (bijv. homelable) en zorg dat Token Permissions (Privilege Separation) correct staat ingesteld.
Klik op Add. Er verschijnt eenmalig een Token ID en een Secret Value. Sla deze veilig op!
Stap 2: Token importeren in Homelable
Open de Homelable webinterface.
Voeg een nieuwe node toe van het type Proxmox of open de integratieinstellingen.
Vul de volgende gegevens in:
Host IP / URL: Het IP-adres of de URL van je Proxmox VE (bijv. https://192.168.1.100:8006).
Token ID: Het ID dat je in de vorige stap hebt gekopieerd (formaat: user@pve!token_naam).
Secret: De geheime sleutel (Secret Value) die Proxmox heeft gegenereerd.
Sla de configuratie op. Homelable haalt nu live de status en resource-data op van je Proxmox-omgeving.
💾 Import- en Exportfunctie Om te voorkomen dat je bij een herinstallatie of verhuizing je zorgvuldig opgebouwde netwerkkaart verliest, is Homelable uitgerust met een robuuste back-up functionaliteit. Export (Back-up maken): Via de instellingen van Homelable kun je de volledige configuratie, inclusief de layout van je canvas en opgeslagen inloggegevens, exporteren naar een JSON-bestand. Sla dit bestand veilig op een externe locatie of cloudopslag op. Import (Back-up herstellen): Bij een nieuwe installatie of op een ander apparaat upload je dit JSON-bestand eenvoudig via de importknop. Je volledige netwerktopologie, live checks en instellingen worden direct in hun oorspronkelijke staat hersteld.