Homebox – mit Docker und Traefik installieren

In dieser Anleitung zeige ich euch, wie ihr Homebox mittels Docker und Traefik bereitstellen könnt. Homebox ist ein Inventar- und Organisationssystem, das speziell für den Heimanwender entwickelt wurde. Es zeichnet sich durch eine einfache und benutzerfreundliche Handhabung aus und bietet eine optimale Lösung für die Inventarisierung, Organisation und Verwaltung. Die intuitive Bedienung von Homebox ermöglicht eine schnelle und unkomplizierte Nutzung. Zudem ist Homebox durch seine effiziente Programmierung in Go, rasend schnell und benötigt nur minimale Ressourcen für die Bereitstellung.

1. Grundvoraussetzung

• Docker & Docker Compose v2 (Debian / Ubuntu)
• TRAEFIK V2 + 3 – REVERSE-PROXY MIT CROWDSEC IM STACK EINRICHTEN

2. Ordner anlegen

mkdir -p /opt/containers/homebox/homebox-data

3. Docker Compose anlegen

nano /opt/containers/homebox/docker-compose.yml

Inhalt

---
services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
    container_name: homebox
    restart: always
    environment:
    - HBOX_LOG_LEVEL=info
    - HBOX_LOG_FORMAT=text
    - HBOX_WEB_MAX_UPLOAD_SIZE=10
    - HBOX_OPTIONS_ALLOW_REGISTRATION=true #By default, user registration is allowed, and to disable this functionality, the variable must be set to false.
    volumes:
      - ./homebox-data:/data/
    networks:
      - proxy
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.homebox.entrypoints=websecure"
      - "traefik.http.routers.homebox.rule=(Host(`homebox.deine-domain.de`))"
      - "traefik.http.routers.homebox.tls=true"
      - "traefik.http.routers.homebox.tls.certresolver=http_resolver"
      - "traefik.http.routers.homebox.service=homebox"
      - "traefik.http.services.homebox.loadbalancer.server.port=7745"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.homebox.middlewares=default@file"
networks:
  proxy:
    external: true

Notwendige Anpassungen:

Traefik Domain anpassen: =(Host(`homebox.deine-domain.de`))

4. Homebox starten

Nun starten wir den Container mittels folgendem Befehl:

docker compose -f /opt/containers/homebox/docker-compose.yml up -d

Wenn ihr nun auf eure Webseite geht, solltet ihr folgendes sehen:

Erstelle dir über den Register Button einen neuen Account.

4.1 Deaktivierung der Benutzerregistrierung

Optional kann nun die Registrierung für neue Benutzer deaktiviert werden.

nano /opt/containers/homebox/docker-compose.yml

Bearbeite folgende Zeile:

    - HBOX_OPTIONS_ALLOW_REGISTRATION=false

Starte den Container neu.

docker compose -f /opt/containers/homebox/docker-compose.yml up -d --force-recreate

Quelle:

Home – Homebox (hay-kot.github.io)