---
title: "Deploy FileBrowser Quantum File Sharing"
description: "FileBrowser Quantum web file manager with login, share links and a volume"
category: "Storage"
url: https://railway.com/deploy/filebrowser-quantum-file-sharing
---

# Deploy FileBrowser Quantum File Sharing

FileBrowser Quantum web file manager with login, share links and a volume

**[Deploy FileBrowser Quantum File Sharing on Railway](https://railway.com/template/filebrowser-quantum-file-sharing)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/filebrowser-quantum-file-sharing/manifest.json

- **Creator:** Anton Orel's Projects
- **Category:** Storage
- **Total deploys:** 5

## Template content

### FileBrowser Quantum

- **Image:** gtstef/filebrowser:2.1.5-beta@sha256:ad68b009f69e66d65a66d5f83f67b9bb5cae588614ac415dc0b23132b939f177
- **Start command:** `/bin/sh -ec 'n=$(printf %s "${FILEBROWSER_ADMIN_PASSWORD:-}" | LC_ALL=C.UTF-8 wc -m) || n=0; if ! [ "$n" -ge 16 ]; then echo "FileBrowser refused to start: FILEBROWSER_ADMIN_PASSWORD must stay set to 16 or more characters" >&2; exit 64; fi; b=$(printf %s "$FILEBROWSER_ADMIN_PASSWORD" | LC_ALL=C wc -c) || b=999; if ! [ "$b" -le 72 ]; then echo "FileBrowser refused to start: FILEBROWSER_ADMIN_PASSWORD must be at most 72 bytes (bcrypt limit)" >&2; exit 64; fi; n=$(printf %s "${FILEBROWSER_TOTP_SECRET:-}" | LC_ALL=C.UTF-8 wc -m) || n=0; if ! [ "$n" -ge 16 ]; then echo "FileBrowser refused to start: FILEBROWSER_TOTP_SECRET must stay set to 16 or more characters" >&2; exit 64; fi; if [ -z "${FILEBROWSER_EXTERNAL_URL:-}" ] && [ -n "${RAILWAY_PUBLIC_DOMAIN:-}" ]; then export FILEBROWSER_EXTERNAL_URL="https://${RAILWAY_PUBLIC_DOMAIN}"; fi; export PORT="${PORT:-8080}" FILEBROWSER_EXTERNAL_URL="${FILEBROWSER_EXTERNAL_URL:-}" FILEBROWSER_CONFIG=/tmp/filebrowser/config.yaml HOME=/home/filebrowser; mkdir -p /tmp/filebrowser /data/files /data/database /data/cache; printf %s IyBGaWxlQnJvd3NlciBRdWFudHVtIGNvbmZpZ3VyYXRpb24gZm9yIHRoZSBSYWlsd2F5IHRlbXBsYXRlLiBUaGUgc3RhcnQgY29tbWFuZCB3cml0ZXMgdGhpcyBmaWxlIHRvCiMgL3RtcC9maWxlYnJvd3Nlci9jb25maWcueWFtbCBvbiBldmVyeSBib290LiAke1ZBUn0gcmVmZXJlbmNlcyBhcmUgZXhwYW5kZWQgYnkgRmlsZUJyb3dzZXIgYWZ0ZXIgdGhlCiMgWUFNTCBpcyBwYXJzZWQsIHNvIHZhcmlhYmxlIHZhbHVlcyBjYW5ub3QgY2hhbmdlIHRoZSBkb2N1bWVudCdzIHN0cnVjdHVyZS4KaHR0cDoKICBwb3J0OiAke1BPUlR9CiAgZXh0ZXJuYWxVcmw6ICR7RklMRUJST1dTRVJfRVhURVJOQUxfVVJMfQogIHRydXN0UHJveHlIZWFkZXJzOiB0cnVlCiAgIyBSYWlsd2F5J3MgZWRnZSBjb25uZWN0cyBmcm9tIGl0cyBwcml2YXRlIDEwMC42NC4wLjAvMTAgcmFuZ2UgYW5kIHJld3JpdGVzIFgtRm9yd2FyZGVkLSogaXRzZWxmLgogIHRydXN0ZWRQcm94aWVzOgogICAgLSAxMDAuNjQuMC4wLzEwCnNlcnZlcjoKICBjYWNoZURpcjogL2RhdGEvY2FjaGUKICBjYWNoZURpckNsZWFudXA6IHRydWUKICBkYXRhYmFzZToKICAgIHBhdGg6IC9kYXRhL2RhdGFiYXNlL2RhdGFiYXNlLnNxbGl0ZQogIHNvdXJjZXM6CiAgICAtIHBhdGg6IC9kYXRhL2ZpbGVzCiAgICAgIG5hbWU6IGZpbGVzCiAgICAgIGNvbmZpZzoKICAgICAgICBkZWZhdWx0RW5hYmxlZDogdHJ1ZQogICAgICAgICMgSWdub3JlIHN5bWJvbGljIGxpbmtzIChmb3IgZXhhbXBsZSBmcm9tIGV4dHJhY3RlZCBhcmNoaXZlcyk6IHB1YmxpYyBzaGFyZSBlbmRwb2ludHMgZm9sbG93IHRoZW0KICAgICAgICAjIGJleW9uZCB0aGUgc2hhcmVkIGZvbGRlci4KICAgICAgICBydWxlczoKICAgICAgICAgIC0gZm9sZGVyUGF0aDogIi8iCiAgICAgICAgICAgIGlnbm9yZVN5bWxpbmtzOiB0cnVlCmF1dGg6CiAgbWV0aG9kczoKICAgIHBhc3N3b3JkOgogICAgICBlbmFibGVkOiB0cnVlCiAgICAgIGFkbWluVXNlcm5hbWU6IGFkbWluCiAgICAgIG1pbkxlbmd0aDogMTIKICAgICAgc2lnbnVwOiBmYWxzZQogICAgcGFzc2tleToKICAgICAgZW5hYmxlZDogZmFsc2UK | base64 -d >/tmp/filebrowser/config.yaml; cd /home/filebrowser; sweep="while :; do find /data/files -type d ! -perm -700 -exec chmod u+rwx {} \; 2>/dev/null; find /data/files -type l -delete 2>/dev/null; sleep 5; done"; if [ "$(id -u)" = 0 ]; then chown 1000:1000 /data /data/files /data/database /data/cache; su -s /bin/sh filebrowser -c "$sweep" </dev/null >/dev/null 2>&1 & exec su -p -s /bin/sh filebrowser -c "exec ./filebrowser"; fi; sh -c "$sweep" </dev/null >/dev/null 2>&1 & exec ./filebrowser'`
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host FileBrowser Quantum File Sharing

FileBrowser Quantum is a web file manager: upload, browse, search, preview and edit files in the browser, and share files or folders through public links. This template runs the official FileBrowser Quantum v2.1.5-beta image (upstream's channel with the current security fixes), pinned by digest, with a generated admin password and a volume that keeps your files, users and share links.

## About Hosting FileBrowser Quantum File Sharing

The template deploys one FileBrowser Quantum service with a 5,000 MB volume at `/data`. Your files live in `/data/files`, the SQLite database with users and share links in `/data/database`, and thumbnails and the search index in `/data/cache`. Sign in as `admin` with the generated `FILEBROWSER_ADMIN_PASSWORD` from the service's Variables tab. FileBrowser applies that variable to the admin account on every start, so change the admin password there and redeploy. Signup is off; create more accounts in the UI. Share links use your Railway domain over HTTPS and survive restarts and redeploys.

## Why Deploy FileBrowser Quantum File Sharing on Railway

Railway gives the UI HTTPS on a public domain, generates the admin password and the 2FA encryption key, and keeps `/data` on a persistent volume. The start command makes Railway's root-owned volume writable for FileBrowser's unprivileged user, keeps the database out of the browsable folder, and refuses to start without a strong admin password, so the service never comes up with a default or logged password. Without a login only the health check, the login form and share links answer.

## Common Use Cases

- Send large files to clients or friends with expiring or password-protected links.
- Collect uploads from others through a shared folder that allows uploads.
- Keep a private cloud drive you can reach from any browser, with previews and search.
- Mount the files over WebDAV with an API token.

## Dependencies for FileBrowser Quantum File Sharing Hosting

- None besides the volume; FileBrowser Quantum stores everything in SQLite and on disk.

### Deployment Dependencies

- [FileBrowser Quantum](https://filebrowserquantum.com)
- [FileBrowser Quantum source](https://github.com/gtsteffaniak/filebrowser)
- [Configuration reference](https://filebrowserquantum.com/en/docs/configuration/)


## Similar templates

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Neo4j 2026.10 Community](https://railway.com/deploy/neo4j-202610-community) — Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

Open this page in a browser: https://railway.com/deploy/filebrowser-quantum-file-sharing
