Ein Verzeichnis voller Fotos, PDFs oder Projektdateien liegt auf deinem Linux-Server, aber du möchtest nicht für jeden Zugriff per SSH oder SMB arbeiten? FileBrowser Quantum macht aus ausgewählten Ordnern eine Weboberfläche für Dateien – mit Upload, Download und Benutzerverwaltung. Für einen Homeserver ist das praktisch, verlangt aber eine saubere Sicherheitskonfiguration: Du solltest schließlich nicht versehentlich dein ganzes Dateisystem für das Internet freigeben. Diese Anleitung zeigt eine nachvollziehbare Neuinstallation der stabilen 2.0-Reihe mit Docker Compose, eigenem Datenverzeichnis, Anmeldeschutz und optionalem HTTPS-Reverse-Proxy.
Versionshinweis: Die offizielle Anleitung trennt FileBrowser Quantum v2.0.x (stable) von einer separat angebotenen v2.1-Beta. Verwende für eine neue stabile Installation den Image-Tag stable. Wer bereits v1.x nutzt, benötigt eine dokumentierte Datenbankmigration und darf dieses Setup nicht einfach als Upgrade über die vorhandene Installation legen.
Was kann FileBrowser Quantum?

Das Projekt bietet eine moderne browserbasierte Dateioberfläche und kann ausgewählte Verzeichnisse als Sources einbinden. Je nach Image-Variante sind Funktionen für Medien- und Dokumentvorschau vorhanden. Das hier verwendete Standard-Image enthält diese zusätzlichen Komponenten, während stable-slim bewusst kompakter ist. Die wichtigste Entscheidung triffst du bereits bei der Einrichtung: Welche Host-Ordner darf der Dienst überhaupt sehen?
1. Voraussetzungen prüfen
Du brauchst Docker Engine, Docker Compose und ein Verzeichnis auf dem Host, auf das der Container zugreifen darf. Für den späteren Zugriff über das Internet benötigst du zusätzlich einen funktionierenden HTTPS-Reverse-Proxy. Diese Installation nutzt als Beispiel ein eigenes leeres Verzeichnis und erteilt ausdrücklich keinen Zugriff auf /, /etc oder den Docker-Socket.
docker --version
docker compose version
docker info --format '{{.DockerRootDir}}'
Beispielausgabe (verkürzt, keine echte Servermessung):
Docker version 28.x.x, build [Beispiel]
Docker Compose version v2.x.x
/var/lib/docker
Die Docker-Root-Ausgabe ist eine Momentaufnahme deines Systems und kann bei Rootless Docker oder anderen Installationen abweichen. Eine funktionierende Compose-Version ist wichtiger als eine bestimmte Ausgabe.
2. Verzeichnisse erstellen
Erstelle ein dediziertes Arbeitsverzeichnis. data enthält später die Konfiguration und SQLite-Datenbank der Anwendung, files ist der Ordner, den du über den Browser verwalten möchtest.
mkdir -p ~/docker/filebrowser-quantum/data ~/docker/filebrowser-quantum/files
cd ~/docker/filebrowser-quantum
pwd
ls -ld data files
Beispielausgabe (verkürzt, keine echte Servermessung):
/home/[BENUTZER]/docker/filebrowser-quantum
drwxr-xr-x 2 [BENUTZER] [GRUPPE] ... data
drwxr-xr-x 2 [BENUTZER] [GRUPPE] ... files
Der Container verwendet im offiziellen Image standardmäßig UID und GID 1000:1000. Unter einem normalen Linux-Host kann dieser Benutzer auf frisch angelegte Verzeichnisse möglicherweise noch nicht schreiben. Kontrolliere deine tatsächlichen Dateirechte und passe nur diese beiden neuen Verzeichnisse an, sofern nötig:
sudo chown -R 1000:1000 ./data ./files
ls -ld data files
Beispielausgabe (verkürzt, keine echte Servermessung):
drwxr-xr-x 2 1000 1000 ... data
drwxr-xr-x 2 1000 1000 ... files
Verwende dieses chown nicht auf deinem gesamten Home-Verzeichnis oder vorhandenen NAS-Freigaben. Falls du produktive Daten mounten möchtest, kläre zuerst Eigentümer, Gruppen, ACLs und gewünschte Zugriffsrechte. Im Zweifelsfall binde sensible Bestandsdaten zunächst schreibgeschützt ein.
3. Konfiguration anlegen
Bei FileBrowser Quantum v2 liegt die Docker-Konfiguration üblicherweise unter /home/filebrowser/data/config.yaml. Dank des Verzeichnismounts kannst du sie auf dem Host als ./data/config.yaml bearbeiten. Lege die Datei vor dem Start an und nutze eine einzige explizite Quelle /folder.
cat > ./data/config.yaml <<'YAML'
server:
sources:
- path: /folder
config:
defaultEnabled: true
auth:
methods:
password:
enabled: true
YAML
Der Befehl erstellt die Konfigurationsdatei und zeigt bei Erfolg normalerweise keine Ausgabe. Mit defaultEnabled: true ist die angelegte Quelle bei der initialen Benutzerkonfiguration verfügbar. Für Mehrbenutzerbetrieb musst du Rechte und Quellen später in der Benutzerverwaltung gezielt einschränken; eine Dateiquelle ist keine automatische Mandantentrennung.
Der Pfad /folder ist ein Pfad innerhalb des Containers und muss zum Volume-Mapping im nächsten Schritt passen. Wenn du stattdessen einen beliebigen Hostpfad hier einträgst, obwohl er nicht gemountet ist, zeigt die Weboberfläche möglicherweise keinen Inhalt.
4. Compose-Datei schreiben
Lege im Arbeitsverzeichnis eine Datei compose.yaml mit folgender Konfiguration an:
services:
filebrowser:
image: ghcr.io/gtsteffaniak/filebrowser:stable
container_name: filebrowser-quantum
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- ./files:/folder
- ./data:/home/filebrowser/data
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
Der Host-Port 8080 ist bewusst ausschließlich an 127.0.0.1 gebunden. Dadurch ist die Anwendung nicht automatisch im gesamten LAN oder Internet erreichbar; für andere Geräte verwendest du im nächsten Schritt einen kontrollierten Proxy oder einen SSH-Tunnel. Der Quellordner files wird in diesem Grundbeispiel beschreibbar eingebunden. Der Container erhält keine anderen Host-Verzeichnisse und keinen Docker-Socket.
Das Tag stable folgt neuen stabilen Releases. Für besonders kritische Installationen empfiehlt sich nach erfolgreichem Test ein konkretes Versionstag oder ein Image-Digest; vor größeren Versionswechseln solltest du die Migrationshinweise lesen.
5. Konfiguration prüfen
Starte nicht sofort blind, sondern lasse Docker Compose zuerst die vollständige Konfiguration prüfen. Damit erkennst du viele Schreibfehler bereits vor dem Start.
docker compose config --quiet
docker compose config --services
Beispielausgabe (verkürzt, keine echte Servermessung):
filebrowser
Der erste Befehl gibt bei Erfolg nichts aus und endet mit Exitcode 0. Bei einer Fehlermeldung überprüfst du die YAML-Einrückung und die Dateinamen. Achte außerdem darauf, dass data/config.yaml eine Datei ist und kein versehentlich angelegtes Verzeichnis.
6. Container starten
Starte nun FileBrowser Quantum und kontrolliere den Zustand:
docker compose up -d
docker compose ps
Beispielausgabe (verkürzt, keine echte Servermessung):
[+] Running 1/1
✔ Container filebrowser-quantum Started
NAME IMAGE STATUS
filebrowser-quantum ghcr.io/gtsteffaniak/filebrowser:stable Up
Das erste Herunterladen des Images kann je nach Verbindung eine Weile dauern. Der Containername und die Ausgabe sind hier nur beispielhaft dargestellt. Wenn der Dienst sofort wieder stoppt, prüfe docker compose logs --tail=80 filebrowser.
7. Erstes Admin-Passwort
Bei einer frischen v2.0-Installation erzeugt FileBrowser Quantum ein zufälliges einmaliges Admin-Passwort, sofern kein alternatives Passwort konfiguriert wurde. Es steht zunächst im Container-Log. Behandle diese Zeile wie ein Geheimnis und kopiere sie nicht in öffentliche Fehlerberichte.
docker compose logs --no-color filebrowser 2>&1 | grep -m1 -i 'initial admin password'
Beispielausgabe (verkürzt, keine echte Servermessung):
filebrowser | Initial admin password: [HIER STEHT DEIN EINMALIGES PASSWORT]
Die zweite Zeile ist ausdrücklich ein Platzhalter. Melde dich mit dem vom Dienst ausgegebenen Passwort an und lege direkt ein eigenes starkes Passwort fest. Konfiguriere kein dauerhaftes FILEBROWSER_ADMIN_PASSWORD in einer öffentlich lesbaren Compose-Datei: Die Projektdokumentation weist darauf hin, dass ein dort gesetztes Passwort bei Neustarts erneut angewendet werden kann.
8. Oberfläche öffnen

Auf dem Server selbst öffnest du http://127.0.0.1:8080 im Browser. Sitzt du an einem anderen Rechner, verwende einen passenden gesicherten Zugriffspfad. Ein SSH-Tunnel ist für einen schnellen Test geeignet: Er verbindet deinen lokalen Browser mit dem nur auf dem Server erreichbaren Port.
ssh -L 8080:127.0.0.1:8080 BENUTZER@SERVER
Ersetze BENUTZER und SERVER durch deine echten SSH-Daten. Solange die SSH-Verbindung läuft, öffnest du auf deinem eigenen Computer http://127.0.0.1:8080. Falls dort bereits eine andere Anwendung Port 8080 verwendet, nimm beispielsweise 8081:127.0.0.1:8080 und öffne anschließend Port 8081 auf deinem Rechner.
9. Eigene HTTPS-Domain
Für den regelmäßigen Zugriff richtest du im bestehenden Reverse Proxy eine Subdomain wie dateien.example.com ein. Wenn Proxy und Docker-Dienst auf demselben Host laufen, kann der Proxy an http://127.0.0.1:8080 weiterleiten. Bei einem Proxy in einem anderen Container musst du stattdessen dessen tatsächlich erreichbare interne Netzwerkadresse verwenden. Aktiviere HTTPS mit gültigem Zertifikat und beachte, dass eine zusätzliche Authentifizierung am Proxy die Benutzerrechte innerhalb von FileBrowser nicht ersetzt.
Erhöhe die erlaubte Uploadgröße im Proxy nur dann, wenn konkrete Uploads daran scheitern und der gewünschte Dateiumfang das rechtfertigt. Gib die Weboberfläche nicht ohne Zugriffskontrolle öffentlich frei, insbesondere wenn darüber Dateien gelöscht oder hochgeladen werden dürfen.
10. Datei- und Benutzerrechte

Melde dich an, lade eine unkritische Testdatei hoch und prüfe, ob sie sich wieder herunterladen lässt. Erstelle anschließend gegebenenfalls weitere Benutzer mit den jeweils nötigen Rechten. Für gemeinsam genutzte Ordner ist die Trennung zwischen Lesen, Hochladen, Ändern und Löschen besonders wichtig. Gewähre Administratorrechte nur dort, wo die Benutzerverwaltung tatsächlich benötigt wird.
Das Mounten eines Host-Ordners gewährt der Anwendung Zugriff auf genau diesen Teil des Dateisystems entsprechend den Betriebssystemrechten. Das ist kein Backup und keine zusätzliche Verschlüsselung. Verwende für besonders wichtige Dokumente ein separates Backup und eine nachvollziehbare Rechtevergabe.
11. Backup und Wiederherstellung
Die beiden gemounteten Verzeichnisse gehören in deine Backup-Strategie: ./files enthält die verwalteten Dateien, ./data unter anderem Konfiguration und SQLite-Datenbank. Ein laufender Datenbankprozess kann bei einer unkoordinierten Dateikopie einen inkonsistenten Stand erzeugen. Für eine einfache konsistente Wartungssicherung kannst du den Dienst stoppen, beide Verzeichnisse gemeinsam sichern und ihn danach wieder starten. In professionellen Umgebungen sind geeignete Snapshot- und Datenbank-Backupverfahren vorzuziehen.
docker compose stop filebrowser
# Jetzt beide Verzeichnisse data/ und files/ konsistent sichern.
docker compose start filebrowser
docker compose ps
Beispielausgabe (verkürzt, keine echte Servermessung):
Container filebrowser-quantum Stopped
Container filebrowser-quantum Started
NAME STATUS
filebrowser-quantum Up
Die Kommentarzeile ist eine Arbeitsanweisung und keine ausführbare Backup-Operation. Ein echtes Backup muss außerhalb des Containers erstellt und regelmäßig durch eine Test-Wiederherstellung kontrolliert werden. Der Dienst ist während dieser Methode kurz nicht erreichbar.
12. Updates durchführen
Prüfe vor einem Update die offiziellen Release Notes, insbesondere bei Änderungen am Datenbankformat. FileBrowser Quantum v2.0 nutzt SQLite und weist ausdrücklich auf eine besondere Migration von v1-Datenbanken hin. Überschreibe daher keine ältere Installation mit einer neuen Compose-Datei ohne die passende Migrationsanleitung.
docker compose pull filebrowser
docker compose up -d filebrowser
docker compose ps
Beispielausgabe (verkürzt, keine echte Servermessung):
[+] Pulling 1/1
✔ filebrowser Pulled
[+] Running 1/1
✔ Container filebrowser-quantum Running
Nach dem Update kontrollierst du Login, Dateiliste, Upload und Download. Bewahre den vorherigen Image-Stand und ein konsistentes Backup auf, um bei unerwarteten Änderungen auf einen bekannten Zustand zurückgehen zu können.
Fehler beheben
Die Oberfläche ist leer: Vergleiche den Source-Pfad in data/config.yaml mit dem Volume-Mapping in Compose. Bei ./files:/folder muss der konfigurierte Source-Pfad /folder lauten.
Uploads scheitern: Prüfe die Rechte der gemounteten Hostordner, die UID/GID des Containerprozesses und den freien Speicher. Setze niemals wahllos chmod -R 777 auf deine Daten.
Kein Zugriff von einem anderen Computer: Die Bindung 127.0.0.1:8080:80 ist absichtlich lokal. Verwende den gesicherten Reverse Proxy oder einen SSH-Tunnel, statt ohne Prüfung Ports im Router freizugeben.
Admin-Passwort fehlt: Prüfe die Startlogs des tatsächlich neuen Containers. Wenn du bereits eine vorhandene Datenbank weiterverwendest, ist es keine frische Installation; benutze dann die offizielle dokumentierte Wiederherstellungsprozedur, statt Datenbankdateien zu löschen.
Container startet nicht: Lasse docker compose config --quiet laufen und kontrolliere docker compose logs --tail=100 filebrowser auf falsche Pfade, Schreibrechte oder ungültige Konfiguration. Entferne nicht einfach alle Sicherheitsoptionen.
Fazit
FileBrowser Quantum bietet einen praktischen und optisch modernen Zugriff auf Serverdateien. Mit einer klar begrenzten Quelle, persistentem Daten- und Konfigurationsordner, sicherem Admin-Passwort und kontrolliertem HTTPS-Zugang eignet sich der Dienst für viele Homeserver-Anwendungen. Der wichtigste Sicherheitsgrundsatz bleibt: Stelle nur die Verzeichnisse bereit, die über den Browser wirklich verwaltet werden sollen.
Offizielle Quellen: FileBrowser Quantum: Docker v2.0, Konfiguration, Umgebungsvariablen. Weiterlesen: Docker-Logs begrenzen.

Schreiben Sie einen Kommentar