Dirflux

Your files, in your browser, on your own server. Browse two folders side by side, upload, edit text, preview images/PDFs/media, share links and recover deleted files.

Beta: Releases · Support

Get started

Install on Unraid

Existing installations: beta.11 changes the internal port to 8080. Keep your host port and update the saved port mapping and WebUI when upgrading.

Find Dirflux in Apps, select Install, choose your files folder and enter an Initial administrator password of 12–1024 characters. Click Apply, open WebUI, and sign in as admin.

Manual installation (Docker → Add Container)

Start with an empty template and fill in these fields:

Use Add another Path, Port, Variable, Label or Device for each row below. These are separate fields, not combined mappings. Name is a display label; container paths, ports and variable keys must match exactly.

For the password entry, enter INITIAL_ADMIN_PASSWORD in Key and your password in Value. Enter values without backticks or quotation marks. Keep the WebUI placeholders literally as shown.

Choose another host port if 8080 is occupied; keep container port 8080. You can change the Files host folder, but Files and Appdata must stay separate, with neither inside the other. Existing files are preserved and must already be accessible to the configured user.

Click Apply. Unraid downloads the public image automatically; no GitHub account, clone or manual image download is needed. Open WebUI or http://YOUR-SERVER:8080 (using your chosen host port), then sign in as admin with your chosen password. The Repository field takes the image address above, not the GitHub website URL.

See the Unraid guide for container restrictions, updates and HTTPS settings.

Other installation options

Without Docker: install Node.js 24.22.1 or newer, clone this repository, then run:

npm ci
npm start

Open http://127.0.0.1:8080. Read data/config/setup-token to create your administrator account. There is no default password.

Docker: install ghcr.io/marcvandecoevering/dirflux:beta (AMD64 / ARM64). Persist /files and /config separately. Use HTTPS for remote access.

Technology and security

All users share one file tree. Public links grant access without login. Media is not transcoded. Keep private configuration outside shared files, back up both directories and use one app process per configuration directory. Do not give untrusted host processes write access to this storage.

See security and known limitations, dependency versions and third-party licenses. A passing scan does not prove that software has no vulnerabilities. Report security issues privately.

Configuration & backups · Native deployment · Contributing

BSD-2-Clause. Inspired by droppy; original assets retain their attribution.