Lokalcan - lokalen Medienkatalog selbst verwalten

Lokalcan ermöglicht es, lokale Dateien und Medien über eine Web-Oberfläche zu katalogisieren und schnell durchsuchbar zu machen.

Was ist Lokalcan?

Lokalcan ist ein selbst gehosteter Medienkatalog, der auf gemountete lokale Verzeichnisse zugreift und deren Inhalte indexiert. Ziel ist es, große Dateisammlungen – Bilder, Videos, Dokumente – ohne Cloud-Abhängigkeit durchsuchbar zu halten. Die Anwendung generiert Vorschaubilder und Metadaten-Einträge aus den gefundenen Dateien und stellt sie in einer browserbasierten Galerie dar. Besonders im Homelab-Kontext ersetzt Lokalcan einfache Dateimanager durch eine ansehnliche, filterfähige Oberfläche.

Voraussetzungen

• Docker 20.10+ / Docker Compose
• Lokales Verzeichnis mit zu katalogisierenden Medien
• Ausreichend Speicherplatz für den Thumbnail-Cache

Compose-Beispiel

services:
  lokalcan:
    image: ghcr.io/lokalcan/lokalcan:latest
    container_name: lokalcan
    restart: unless-stopped
    ports:
      - "8484:8484"
    volumes:
      - ./media:/media:ro
      - ./cache:/app/cache
      - ./db:/app/db
    environment:
      - TZ=Europe/Berlin
      - MEDIA_ROOT=/media
      - APP_SECRET=change_me_secret_key

Hinweise

• Mediendateien am besten read-only mounten (:ro), damit der Container keine versehentlichen Änderungen vornehmen kann.
• Der erste Scan großer Bibliotheken kann mehrere Minuten dauern – Logs im Auge behalten.
• Den Thumbnail-Cache regelmäßig aufräumen, wenn Dateien aus der Bibliothek entfernt werden.
• Für Remotezugriff Reverse Proxy mit HTTPS und Authentifizierung vorschalten – der Inhalt sollte nicht ungeschützt im Internet erreichbar sein.

Links

• GitHub
• Dokumentation