filebrowser
| Version | 2026.162.1430 |
| Repo | superproject |
Browser-based file manager (FileBrowser Quantum) served over HTTP on port 8080
Downloads the gtsteffaniak/filebrowser ${FILEBROWSER_VERSION} static
binary to /usr/local/bin/filebrowser (0755), writes its server config
to /etc/filebrowser/config.yaml (listen port 8080, SQLite database + a
“Files” source under ~/.filebrowser/files), and runs it as the
always-restart filebrowser service under the init system. The data
and files volumes persist the database and the user-browsable tree.
Every fact below is observable: the installed binary, the config
contents, the running service, and the HTTP 200 the web UI returns.
Services
Section titled “Services”filebrowser
Acceptance plan
Section titled “Acceptance plan”This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.
| Intent | Step |
|---|---|
run |
download=https://github.com/gtsteffaniak/filebrowser/releases/download/${FILEBROWSER_VERSION}/linux-${ARCH}-filebrowser |
run |
mkdir=/etc/filebrowser |
run |
copy=config.yaml |
check |
the filebrowser binary is installed and executable at /usr/local/bin/filebrowser |
check |
the server config is present at /etc/filebrowser/config.yaml |
check |
the config declares the listen port 8080 |
check |
the filebrowser service is running under the init system |
check |
the web UI answers HTTP 200 on the published port |
check |
addr=127.0.0.1:${HOST_PORT:8080} |
check |
file=${VOLUME_CONTAINER_PATH:data} |