Homarr op CasaOS/ZimaOS: huidige Docker Compose-configuratie

Kortom: gebruik de huidige Docker Compose-methode van Homarr in plaats van de BigBear-sjabloon uit 2023

Het oude CasaOS-bericht was nuttig toen BigBearCasaOS Homarr verpakte voor installatie met één klik. Homarr is aanzienlijk veranderd. De huidige selfhostingworkflow gebruikt Compose en bewaart de status onder /appdatavereist een SECRET_ENCRYPTION_KEYen kan optioneel de Docker-socket koppelen voor containerintegraties.

Begin met een persistente Compose-definitie

services:
  homarr:
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    ports:
      - "7575:7575"
    volumes:
      - /DATA/AppData/homarr:/appdata
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - SECRET_ENCRYPTION_KEY=REPLACE_WITH_64_HEX_CHARS

De huidige Homarr Docker-installatie raadt Compose aan en documenteert /appdata.

Genereer de versleutelingssleutel vóór de eerste start

openssl rand -hex 32

Homarr gebruikt dit geheim om gevoelige integratiegegevens te beschermen. Houd het buiten openbare Compose-exports. De veilige generatie van willekeurige waarden van OpenSSL legt het commando uit.

Koppel de Docker-socket alleen indien nodig

De Docker-socket biedt krachtige controle over de host. Als Homarr alleen links, bladwijzers en externe widgets nodig heeft, laat je deze weg. Voeg de socket alleen toe voor Docker-bewuste integraties die je bewust gebruikt.

Gebruik de ZimaOS OpenAPI voor ZimaOS-gegevens

Gebruik voor opslag- of systeemstatus de gepubliceerde ZimaOS OpenAPI in plaats van dashboard-HTML te scrapen. De ZimaOS-appvereisten behandelen de planning van resources.

Houd Homarr intern totdat authenticatie gereed is

Een dashboard kan interne IP-adressen, poorten en de infrastructuurstatus blootleggen. Publiceer het niet rechtstreeks zonder authenticatie en HTTPS. De ZimaOS HTTPS-proxy biedt de laag voor openbare toegang.

Homarr als container bijwerken

docker compose down
docker compose pull
docker compose up -d

Persistent /appdata blijft behouden. Daarom is het volume belangrijker dan het behouden van de oude container.

Plaats de Homarr-configuratie niet alleen in de container

Als /appdata niet is gekoppeld aan permanente opslag op de host, kan het opnieuw aanmaken van de container de configuratie wissen. Maak een back-up van de Homarr-map op de host. De ZimaOS-back-up biedt de herstelbasis.

Gebruik Homarr als voordeur, niet als omzeiling van beheer

Homarr kan links en alleen-lezenstatus centraliseren, maar elke onderliggende app heeft nog steeds eigen authenticatie. Plaats geen beheerdersreferenties in openbare widgets voor toegang met één klik.

Bouw het dashboard stapsgewijs op in plaats van alles op dag één te verbinden

Begin met eenvoudige links naar ZimaOS, Plex, Home Assistant en andere services. Voeg, zodra het dashboard zelf stabiel is, één integratie per keer toe. Zo zie je duidelijk welke integratie een aanmeldingslus, een trage paginalading of een toestemmingsprobleem veroorzaakt. Een dashboard met twintig API-integraties kan eruitzien als één defecte app, terwijl slechts één backend een time-out heeft.

Gebruik interne hostnamen of stabiele LAN-IP-adressen

De huidige containerinstructies van Homarr raden een hostnaam of direct IP-adres aan dat clients op je netwerk kunnen omzetten. Als je een reverse proxy gebruikt, houd de openbare hostnaam consistent en zorg ervoor dat WebSocket-/API-aanvragen dezelfde origin gebruiken. Vermijd het hardcoderen van tijdelijke Docker-IP-adressen, omdat die kunnen veranderen wanneer containers opnieuw worden aangemaakt.

Maak meer back-ups dan alleen de mooie indeling

Je dashboard kan versleutelde integratiereferenties, gebruikersaccounts, pictogrammen en servicemetagegevens bevatten. Bewaar de volledige permanente /appdata map samen met de versleutelingssleutel. Test een herstelbewerking naar een wegwerp-Homarr-container voordat je op de back-up vertrouwt.

Wees voorzichtig met automatische containerupdates

Een dashboard is vaak de eerste plek waar je merkt of de rest van het homelab gezond is. Als Homarr automatisch wordt bijgewerkt en tegelijk met een andere service defect raakt, wordt de diagnose moeilijker. Zet een bekende, goed werkende versie vast of werk handmatig bij wanneer uptime belangrijk is, en ga daarna verder na het testen.

Noteer na elke geslaagde upgrade de exacte Homarr-image-tag, zodat terugdraaien eenvoudig blijft.

Veelgestelde vragen

Is BigBearCasaOS nog steeds vereist voor Homarr?

Nee. Homarr publiceert zijn eigen actuele installatieprocedure voor Docker en Compose.

Wat is SECRET_ENCRYPTION_KEY?

Het is een permanent geheim dat Homarr gebruikt om gevoelige integratiegegevens te beschermen.

Heb ik de Docker-socket nodig?

Alleen voor Docker-bewuste integraties of containerbeheer.

Kan Homarr ZimaOS-systeemgegevens weergeven?

Mogelijk via aangepaste integraties met de ZimaOS OpenAPI.

Hoe werk ik Homarr veilig bij?

Bewaar /appdata, haal de nieuwere image op, maak de service opnieuw aan en controleer het dashboard voordat je oude images opruimt.