File Browser
Install File Browser as a service that serves the whole filesystem of the system it runs on.
filebrowser.sh installs the filebrowser/filebrowser release binary and a
service that serves / 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.sh |
Run
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/addon/filebrowser.sh)"Prompts
| Prompt | Answer |
|---|---|
Enter port number (Default: 8080): | Listening port. Empty keeps 8080 |
Would you like to install FileBrowser? (y/n): | y installs. Anything else exits |
Would you like to use No Authentication? (y/N): | y sets auth.method=noauth: 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 |
|---|---|
Would you like to uninstall FileBrowser? (y/N): | y removes it |
Would you like to update FileBrowser? (y/N): | y updates. Anything else exits |
What it creates
| Item | Value |
|---|---|
| Packages | tar, curl |
| Binary | /usr/local/bin/filebrowser |
| Database | /usr/local/community-scripts/filebrowser.db (mode 600) |
| Service | filebrowser (systemd unit /etc/systemd/system/filebrowser.service, or OpenRC script /etc/init.d/filebrowser on Alpine), runs as root with -r / |
| Listen address | 0.0.0.0, the chosen port |
| Login | User admin, random 20-character password, saved to ~/filebrowser.creds (mode 600). Not written when you choose No Authentication |
Update
Run the script again and answer y to the update question. If a newer
release of filebrowser/filebrowser exists, the binary at
/usr/local/bin/filebrowser is replaced. The script does not restart the
service afterwards; restart filebrowser yourself to run the new binary.
There is no type=update mode and no update_ helper, so the container's
update command does not offer File Browser.
Remove
Answering y to the uninstall question stops and disables the service and
deletes the service file, the binary and the database
/usr/local/community-scripts/filebrowser.db. ~/filebrowser.creds stays.
Limits
- The service runs as root and serves
/. Keep authentication on unless the port is reachable only by you. - It uses the same binary path and service name as FileBrowser Quantum. Only one of the two can be installed on a system.