FileBrowser Quantum
Install FileBrowser Quantum as a service that serves the whole filesystem of the system it runs on.
filebrowser-quantum.sh installs the gtsteffaniak/filebrowser release binary,
writes a YAML configuration with / as its only source and starts it as root.
| Run it | Inside the container or VM. If /etc/pve exists the script warns that only the boot disk is visible on a Proxmox VE host and asks Continue anyway on the Proxmox host? (y/N) |
| Supported OS | Debian family (checks /etc/debian_version) and Alpine. Anything else exits with code 238 |
| Port | 8080 by default, asked at install |
| Source | tools/addon/filebrowser-quantum.sh |
Run
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/addon/filebrowser-quantum.sh)"Prompts
| Prompt | Answer |
|---|---|
Uninstall legacy FileBrowser and continue with Quantum install? (y/n): | Shown when an installation of the File Browser add-on is detected. y removes its service, binary and database, then continues. Anything else exits |
Enter port number (Default: 8080): | Listening port. Empty keeps 8080 |
Install FileBrowser Quantum? (y/n): | y installs. Anything else exits |
Use No Authentication? (y/N): | y writes auth.methods.noauth: true: anyone who reaches the port can read and change every file. Anything else creates an admin user with a random password |
When /usr/local/bin/filebrowser already exists:
| Prompt | Answer |
|---|---|
Uninstall FileBrowser Quantum? (y/N): | y removes it |
Update FileBrowser Quantum? (y/N): | y updates. Anything else exits |
What it creates
| Item | Value |
|---|---|
| Packages | curl, ffmpeg |
| Binary | /usr/local/bin/filebrowser |
| Configuration | /usr/local/community-scripts/fq-config.yaml (mode 600 when it holds a password) |
| Source | Path /, named RootFS. /proc, /sys, /dev, /run, /tmp and /lost+found are excluded with neverWatchPath rules |
| Service | filebrowser (systemd unit /etc/systemd/system/filebrowser.service, or OpenRC script /etc/init.d/filebrowser on Alpine), runs as root, working directory /usr/local/community-scripts |
| Login | User admin, random 20-character password, saved to ~/filebrowser-quantum.creds (mode 600). Not written when you choose No Authentication |
With authentication, the configuration first contains adminPassword. The
script waits up to 30 seconds for http://127.0.0.1:<port>/health to answer
and then deletes that line again, because the setting would reset the password
on every start.
Update
Run the script again and answer y to Update FileBrowser Quantum?. If a
newer release exists, the script:
- Replaces
/usr/local/bin/filebrowser. - Removes any
disableIndexing:line from the configuration. - Converts a version 1 configuration: the old file is kept as
fq-config.yaml.v1.bak, eachconditionals:line is removed and the entries below it move up one level,indexingIntervalMinutes:lines are dropped,server.portmoves tohttp.port, and an existingdatabase.dbis renamed todatabase.db.oldand referenced asmigrateFrom. - Restarts the service.
There is no type=update mode and no update_ helper, so the container's
update command does not offer FileBrowser Quantum.
Remove
Answering y to the uninstall question stops and disables the service and
deletes the service file, the binary and fq-config.yaml. Database files in
/usr/local/community-scripts and ~/filebrowser-quantum.creds stay.
Limits
- The service runs as root and serves
/. Keep authentication on unless the port is reachable only by you. - The source path and its name are fixed in the script; change them in
fq-config.yamlafterwards.