How to self-host File Browser Quantum

See, upload and organise your files — with previews and a built-in editor. Cresdock runs it on a server you own, from a catalogue, with no Docker and no reverse proxy to configure.

What Cresdock does for you with File Browser Quantum

Its configuration is written before the container ever starts — including the web address it lives at, so File Browser Quantum generates correct links from the first page load instead of half-working behind a prefix.
Reached through your panel login. There is no second password to invent for File Browser Quantum and no port to open on your firewall.
Your Downloads and Media folders are already mounted, and they are the SAME folders your other apps see — so files land where the rest of your setup expects them, with no path mapping to work out.
If your library lives on cloud storage rather than the server's own disk, this app can read it from there.
File Browser Quantum works over the same folders your other apps use, with previews and an editor added — nothing to connect.
It and File Browser do the same job over the same folders, so most people keep one.

Why run File Browser Quantum yourself

Cloud storage is rented, priced per month forever, and readable by whoever runs it. The same files on a server you own cost what the disk cost.

It is also how you retire Dropbox or Google Drive — one line in replacing cloud subscriptions, app by app.

What kind of server File Browser Quantum needs

Light on power, heavy on disk — sizing is really a question of how much you want to keep. If your library outgrows the server, Cresdock can put it on cloud storage and keep it looking like a normal folder.

Cresdock itself is undemanding — it runs on a small rented server, an old desktop or a mini PC, on Ubuntu or Debian. Everything it installs shares that machine, so the honest question is not "will this app run" but "how much am I going to put on here in total".

Where to run File Browser Quantum

File Browser Quantum runs wherever Cresdock runs, and the choice is about the machine, not the app:

At home, on hardware you already own. A mini PC, an old desktop or a NAS that can run Debian. Cresdock works behind a home router with no port forwarding and no domain, so File Browser Quantum is reachable on your own network first and from outside only if you choose.
On a rented server. A small VPS is enough for most apps and is the usual answer when File Browser Quantum should be reachable from anywhere. The setup guide covers the specs and the one-command install.
Through a provider that runs Cresdock. Hosting companies deploy Cresdock workspaces for their customers, so File Browser Quantum can come with a server you rent rather than one you set up — ask your provider, or see how providers offer it.

Installing File Browser Quantum

Put Cresdock on a server
One line on any Ubuntu or Debian machine — a rented VPS, a spare PC, a home server. It sets itself up.
Pick File Browser Quantum from the catalogue
Click Install. The panel pulls the image, writes the configuration, gets a certificate and starts it.
Open it from your dashboard
Its address and any login details are on its card. Start, stop, update, roll back or remove it from the same place, any time.

What this replaces

Doing it by hand means writing something like this, then keeping it working:

services:
  quantum:
    image: gtstef/filebrowser:1.5.0-stable
    restart: unless-stopped
    ports:
      - "80:80"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - ./quantum/config:/config
      - ./downloads:/downloads
      - ./media:/media

And that is the easy half. Still to do:

Install a reverse proxy and write a server block for it
Get a TLS certificate and set up automatic renewal
Create the folders above with the right ownership, or it will not start
Repeat all of it for the next app, and again on every server rebuild

On Cresdock, File Browser Quantum is one click and none of the above exists.

Common questions

Do I need to know Docker to run File Browser Quantum?

No. Cresdock installs File Browser Quantum in one click from its catalogue: it pulls the image, writes the configuration, gets an HTTPS certificate and starts it. File Browser Quantum's configuration is written before it first starts, so it opens already set up.

What happens to my files when File Browser Quantum updates?

Cresdock changes File Browser Quantum's own configuration only. Your downloads and your media are never touched by an update, a rebuild or a reinstall — that is a rule the software enforces, not a promise in a document.

Who can see the files I put in File Browser Quantum?

Only you. Your folders belong to your account, other people on the server have their own, and each account's apps run on a private network of their own. Updates and reinstalls never touch what you have stored.

Can I run File Browser Quantum at home instead of on a VPS?

Yes. Cresdock runs on a mini PC, an old desktop or anything that boots Debian, behind a normal home router with no port forwarding, and File Browser Quantum is reachable on your own network first. A rented server is only needed when File Browser Quantum must be reachable from anywhere without a VPN.

Can I remove File Browser Quantum later?

Yes. Cresdock removes File Browser Quantum in one click, and asks whether to keep its configuration for a future reinstall. Nothing else you have installed is affected.

Looking for what File Browser Quantum itself can do? That lives in its own documentation — this page is only about running it.

Pairs well with: Rclone · SFTPGo · Radarr

Before you start: where to rent a server · what it needs to run · Cresdock vs CasaOS