ov-layers/skills/filebrowser/SKILL.md
FileBrowser Quantum web file manager on port 8080 with config-file-driven setup. Use when working with FileBrowser, web file management, or file browsing in containers.
npx skillsauth add overthinkos/overthink-plugins filebrowserInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| Property | Value |
|----------|-------|
| Dependencies | supervisord |
| Ports | 8080 |
| Volumes | data -> ~/.filebrowser/data, files -> ~/.filebrowser/files |
| Service | filebrowser (supervisord) |
| Install files | tasks:, config.yaml |
| Variable | Value |
|----------|-------|
| FILEBROWSER_CONFIG | /etc/filebrowser/config.yaml |
| Name | Command |
|------|---------|
| filebrowser | filebrowser |
FileBrowser Quantum (gtsteffaniak fork, v1.2.4-stable) is config-file driven -- it uses
/etc/filebrowser/config.yaml, NOT CLI flags like classic filebrowser. The FILEBROWSER_CONFIG
environment variable points to the config file.
Default credentials: admin / admin. Change immediately after first login via the web UI.
Database and cache stored in the data volume (~/.filebrowser/data/database.db).
User-accessible files served from the files volume (~/.filebrowser/files).
The files volume is typically bind-mounted to a host directory at deploy time:
ov config filebrowser --bind files=~/Documents
ov config filebrowser --bind files=/mnt/nas/shared
# image.yml
filebrowser:
base: fedora
layers:
- agent-forwarding
- filebrowser
- dbus
- ov
ports:
- "8085:8080"
Tunnel config is in deploy.yml: tunnel: {provider: tailscale, private: all}. See /ov:deploy.
/ov-images:filebrowser/ov-layers:supervisord -- process manager dependency/ov-layers:traefik -- similar pattern (binary download + config file + supervisord)/ov-layers:dbus -- D-Bus session bus (co-deployed in filebrowser image)/ov-layers:ov -- ov CLI (co-deployed in filebrowser image)/ov:config -- deployment configuration, --bind files=<path> for file volume/ov:start -- start the service/ov:shell -- interactive access to the containerUse when the user asks about:
FILEBROWSER_CONFIG configuration/ov:layer — layer authoring reference (layer.yml schema, task verbs, service declarations)/ov:test — declarative testing (tests: block, ov image test, ov test)tools
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
development
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
tools
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
tools
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.