FileBrowser Quantum

A fast web file manager with search, previews and share links.

  • ghcr.io/hsinghhira/filebrowser-quantum:latest
  • v2.0.2-stable
  • Updated 16 Nov 2026
  • port 6738
  • amd64 · arm64
  • Others
  • 9.3k stars

Screenshots

FileBrowser Quantum screenshot 1: Files

Open the app

Web UI

http://localhost:6738/

About FileBrowser Quantum

FileBrowser Quantum is a web file manager for your files. Browse, upload, move and share files from any browser, find anything in a second with its search index, and preview photos, videos and documents without downloading them.

Features

  • Very fast search across all your files
  • Previews and thumbnails for images, videos, PDFs and Office files
  • Share links with expiry and passwords
  • Users with their own folders and permissions
  • Sign-in with a password, OIDC or a proxy, with two-factor codes
  • Upload large files and whole folders

How to use

  1. Open http://[ZIMAOS-IP-ADDRESS]:6738 and sign in as admin. The password is in the app's logs, in the box marked CREDENTIALS.
  2. Browse your files under files.
  3. Right-click a file or folder to share, move or rename it.

Before you install

Leave FILEBROWSER_ADMIN_PASSWORD blank and the app makes a random admin password on first start. It is printed in the app's logs, in the box marked CREDENTIALS, and saved in /DATA/AppData/filebrowser-quantum/data/password.txt. The app sees all of /DATA and runs as root so it can change those files; to share less, point the /srv folder at a smaller one, like /DATA/Media. A starter config.yaml is made in the app folder on first start; edit it with the Files app for more sources, OIDC, OnlyOffice and the rest (it is never overwritten). The first start indexes your files, which can take a few minutes on big disks.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.
FILEBROWSER_ADMIN_PASSWORD—The admin's password. Leave it blank and the app makes a random one on first start; find it in the app's logs, in the box marked CREDENTIALS. Only used when the admin is made; change it later in FileBrowser.

Sign in with OIDC

VariableDefault valueDescription
FILEBROWSER_OIDC_CLIENT_ID—The client ID from your OIDC provider. Turn OIDC on and set its issuer in config.yaml (auth, methods, oidc).
FILEBROWSER_OIDC_CLIENT_SECRET—The client secret from your OIDC provider.

Security

VariableDefault valueDescription
FILEBROWSER_JWT_TOKEN_SECRET—Your own secret for signing logins. Leave it out to let FileBrowser manage one.
FILEBROWSER_TOTP_SECRET—A secret for two-factor codes. Leave it out to let FileBrowser manage one.

Office

VariableDefault valueDescription
FILEBROWSER_ONLYOFFICE_SECRET—The JWT secret of your OnlyOffice Docs server, for editing Office files. Set its address in config.yaml (integrations, office).
docker-compose.yml
name: filebrowser-quantum

services:
  filebrowser-quantum:
    image: ghcr.io/hsinghhira/filebrowser-quantum:latest
    container_name: filebrowser-quantum
    restart: unless-stopped
    stop_grace_period: 20s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - FILEBROWSER_ADMIN_PASSWORD=
    ports:
      - target: 80
        published: "6738"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /home/filebrowser/data
        bind:
          create_host_path: true
      - type: bind
        source: /DATA
        target: /srv
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://127.0.0.1:80/health"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 60s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1024M
        reservations:
          cpus: "0.00"
          memory: 64M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/filebrowser-quantum/icon.png
    x-casaos:
      id: com.icestore.filebrowser-quantum
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: FILEBROWSER_ADMIN_PASSWORD
          description:
            en_US: >-
              The admin's password. Leave it blank and the app makes a random
              one on first start; find it in the app's logs, in the box
              marked CREDENTIALS. Only used when the admin is made; change
              it later in FileBrowser.
      ports:
        - container: "80"
          description:
            en_US: FileBrowser Quantum web page and WebDAV, published on host as 6738
      volumes:
        - container: /home/filebrowser/data
          description:
            en_US: >-
              FileBrowser's settings (config.yaml), user database, cache and
              the first admin password (password.txt). Back this folder up.
        - container: /srv
          description:
            en_US: >-
              The files FileBrowser shows: all of your ZimaOS /DATA folder.
              Change this to a smaller folder to share less.

x-casaos:
  id: com.icestore.filebrowser-quantum
  architectures:
    - amd64
    - arm64
  main: filebrowser-quantum
  author: HSinghHira
  category: Others
  developer: gtsteffaniak
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/filebrowser-quantum/icon.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/filebrowser-quantum/screenshot-1.jpg
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/filebrowser-quantum/screenshot-1.jpg
  title:
    en_US: FileBrowser Quantum
  tagline:
    en_US: A fast web file manager with search, previews and share links.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/filebrowser-quantum/](https://icestore.hsinghhira.me/app/filebrowser-quantum/) for full details


      FileBrowser Quantum is a web file manager for your ZimaOS files. Browse,
      upload, move and share files from any browser, find anything in a
      second with its search index, and preview photos, videos and
      documents without downloading them.


      **Features**


      - Very fast search across all your files

      - Previews and thumbnails for images, videos, PDFs and Office files

      - Share links with expiry and passwords

      - Users with their own folders and permissions

      - Sign-in with a password, OIDC or a proxy, with two-factor codes

      - Upload large files and whole folders


      **How to use?**


      1. Open http://[ZIMAOS-IP-ADDRESS]:6738 and sign in as admin. The
         password is in the app's logs, in the box marked CREDENTIALS.


      2. Browse your ZimaOS files under files.


      3. Right-click a file or folder to share, move or rename it.
  tips:
    before_install:
      en_US: >-
        1. Leave FILEBROWSER_ADMIN_PASSWORD blank to get a random password,
           or type your own.


        2. The app sees all of /DATA. To share less, change the /srv folder
           to a smaller one, like /DATA/Media.


        3. Start the installation. The first start indexes your files, which
           can take a few minutes for big disks.


        4. Your login details and the app's address are in the app's logs,
           in the box marked CREDENTIALS. It is printed again on every start.


        5. Open http://[ZIMAOS-IP-ADDRESS]:6738 in your browser, like
           http://192.168.1.20:6738, and sign in as admin.


        6. More settings, like OIDC sign-in, are listed on the FileBrowser
           Quantum page at
           https://icestore.hsinghhira.me/app/filebrowser-quantum/
           (Variables tab). You can add them now or later in the app
           settings.
  index: /
  port_map: "6738"
  scheme: http
  is_uncontrolled: false
  version: "2.0.2-stable"
  update_at: "2026-11-16"
  release_notes:
    en_US: |-
      - First IceStore version, built on gtstef/filebrowser 2.0.2-stable
      - A starter config.yaml is made on first start, with your /DATA folder as the source
      - Each install makes its own random admin password, shown in the CREDENTIALS box
      - Web page on port 6738
  repo: "https://github.com/gtsteffaniak/filebrowser"
  support: "https://github.com/gtsteffaniak/filebrowser/issues"
  docs: "https://filebrowserquantum.com/en/docs/"

Install FileBrowser Quantum

Something not working with FileBrowser Quantum?

Report it so it gets fixed, or ask for an app that is not here yet.

More Others apps

See all