bitdruid/filewall repository overview

⁠about

Filewall shows every file of a bind-mounted folder as a gallery of cards to browse, view and clean up a shared folder from any browser.

• one card per file with bare infos only: filename, size, modified date and a filetype badge
• image files render as cached webp thumbnail and open in a large lightbox view on click
• filter toggle: only image files (default) or all files
• folder toggle: browse the real folder structure instead of the flat gallery
• select one or multiple files (shift-click selects the whole range, or select all) and delete them
• download marked files: single file directly, multiple bundled as zip
• recursive listing, hidden files and folders are skipped
• light / dark / auto theme, accent and surface flavor switchers (persisted per browser, incl. favicon)
• view the application log in a dedicated tab (with level filtering)
• optional single-user login

⁠run

⁠docker

⁠get image

docker pull bitdruid/filewall:latest

docker buildx build -t bitdruid/filewall:latest . --load

⁠compose

docker-compose up -d

⁠script

bash start.sh [options]

Options:

• -d, --data-dir PATH - Folder shown in the gallery (default: filewall/data/ inside the package)
• -b, --base-path PATH - Public base path when hosting under a subdirectory (example: /subdir1/app)
• -u, --login-user USER - Enable login with this username
• -w, --login-pw PW - Password for the login user
• -t, --login-timeout MIN - Session idle timeout in minutes (default: 60)
• --help - Show help message

⁠cli

• requires Python >= 3.13

pipx install .
# or: uv tool install .

filewall

Options:

• --host HOST - Interface to bind the server to (default: 0.0.0.0)
• --port PORT - Port for the server (default: 5000)
• --data-dir PATH - Folder shown in the gallery (default: data/ inside the package)
• --base-path PATH - Public base path when hosting under a subdirectory (example: /subdir1/app)
• --login-user USER - Enable login with this username (requires --login-pw)
• --login-pw PW - Password for the login user (requires --login-user)
• --login-timeout MIN - Session idle timeout in minutes (default: 60)
• --reload - Auto-reload on code changes (development only)

⁠envs

Table for envs:

⁠volumes

Table for volumes: