SSD Nodes Learn Hosting plans →
How to do am Matt ConnorBy Matt Connor · Updated 2026-11-04

Self-hosted File Manager: Which One Make Sense?

Compare FileBrowser, Filestash, SFTPGo and Cloud Commander for scoping, share links, storage backends and auth, plus safer ways to run one.

Wetin self-hosted file manager be, and wetin e no be

Self-hosted file manager na web page wey dey show directory tree wey already dey your VPS (virtual private server). You go log in, see /srv/files exactly as e dey for disk, then upload, rename, download, or give person link. Nothing dey copy go another system, so file wey you drop for browser na the same file wey ls go show one second later.

Search results dey mix this up with software wey dey do other work. Sync tools dey keep copy of every file for every device, and na wetin self-hosted Dropbox alternative dey for. Object storage dey use buckets and API instead of directory for your disk, so running MinIO for S3 compatible object storage dey answer different question. Server admin panels dey manage the machine, no be the files, and na wetin Cockpit and Webmin comparison dey cover.

You need file manager when colleague need one 300 MB archive from the server, or when you wan correct typo for config file from phone. The work small, and the tools sef small.

Keep one fact for mind as you read. This na web application wey get read and write access to your filesystem, and e dey listen on a port. Every choice wey follow na really choice about how much of your disk that process fit reach.

FileBrowser don archive, so read this before you install am

FileBrowser, the filebrowser/filebrowser project, na the answer wey most guides still dey give. Its README now start with one notice:

File Browser don archive on 2026-09-01. The last planned release don already ship. No more releases, bug fixes, or security fixes go dey.

The Apache 2.0 code still dey work. But security fixes don stop. This matter pass for this category than for most others, because the software main purpose na to give write access to filesystem through HTTP.

The maintainers write down how to continue using am, and the advice good to follow no matter which tool you choose: no expose am directly to internet, put am behind reverse proxy wey terminate TLS (transport layer security) and do its own authentication, keep the command runner disabled, and run am unprivileged inside container with only the directory wey you intend to serve mounted inside am.

One line for that README matter pass the rest. Sessions na self-contained JWTs (JSON web tokens), instead of server-side identifiers, so you no fit revoke dem. If session token leak, e go remain valid until e expire, and changing password no go kill am. If you continue to use FileBrowser, the authentication layer wey dey in front of am na the one wey dey do the real work. If you prefer to comot from am, how to move File Browser go FileBrowser Quantum dey show the order: hide the old instance from internet, back up filebrowser.db, write config.yaml, then start Quantum.

FileBrowser Quantum: fork wey still dey move

Active development don move go one fork, FileBrowser Quantum (gtsteffaniak/filebrowser), wey dem publish as gtstef/filebrowser image for Docker Hub and as ghcr.io/gtsteffaniak/filebrowser for GitHub's registry. E rebuild configuration around one config.yaml instead of the older mix of command line flags and database settings. The documented quick try be:

docker run -d \
  -v $(pwd):/srv \
  -p 80:80 \
  ghcr.io/gtsteffaniak/filebrowser:stable

This one go serve the current directory for http://localhost. Since version 2.0.0, the first login no longer be admin / admin. Unless you set adminPassword for the config to something wey no be admin, the container go generate random admin password, log am once, so read am with docker logs, and require password reset for first login. Complete that reset before the container fit reach from anywhere apart from your own machine.

For instance wey you go keep, use Compose, mount the data directory instead of one database file, and bind the port to localhost:

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    user: "1000:1000"
    volumes:
      - /srv/files:/folder
      - ./data:/home/filebrowser/data
    ports:
      - 127.0.0.1:8080:80
    restart: unless-stopped

The config dey for /home/filebrowser/data/config.yaml and the database dey for /home/filebrowser/data/database.sqlite. Version 2.0.0 change the database format and dey perform one-time migration. Na why the docs ask for directory mount: single file mount no give the migration place to put the new file. The paths inside config.yaml na container paths, so source for the config dey read /folder, not /srv/files. If you mix this up, e go produce empty file list without error, because the directory truly no dey there.

The project dey publish latest and stable for around 60 MB with FFmpeg and document previews bundled, and stable-slim for around 15 MB with only the core. Na these figures dey for the install page for October 2026. Pin the tag wey you choose. latest dey change without telling you, and file manager wey change e config format while container dey run fit spoil your morning.

For this work, na the strongest among the small tools. E fit serve multiple sources with include and exclude rules, so one instance fit expose /srv/media and /srv/docs with different scope. Shares get expiration time and fit be anonymous or restricted to one user. Authentication cover OIDC (OpenID Connect), LDAP (lightweight directory access protocol), password with two factor, and proxy header mode. Na this proxy mode make e fit sit behind single sign on (SSO) from self-hosted Authentik server instead of keeping second list of users.

Filestash: one interface over storage wey you already get

Filestash na different kind tool. E na front end wey dey connect to backend, and e support plenty backend: FTP, SFTP (SSH file transfer protocol), S3, SMB, WebDAV, IPFS and about twenty more. E useful when the files no dey the same machine wey dey run the interface.

mkdir -p /srv/filestash && cd /srv/filestash
curl -O https://downloads.filestash.app/latest/docker-compose.yml
docker compose up -d

The image na machines/filestash:latest. Open http://your_domain:8334 and the first screen go ask you to set admin password. Set am immediately, because until you do am, anybody wey find the port fit enter admin console.

Understand the identity model before you build anything around am. By default, Filestash no keep user database for the usual way. Credentials dey stored for your browser through cookies wey encrypted, authenticated and HTTP only, and nothing dey kept for server side unless you use the share feature. When you use that feature, Filestash dey keep persistent encrypted version of your credentials. For this default setup, the "users" na storage accounts: identity dey for the backend, inside the SFTP account or the S3 key, not for Filestash. This no be the only option. The plg_authenticate_local plugin, wey dey ship inside the open source repository, make Filestash act as the identity provider by itself, with screen wey you fit use manage users.

That design clean, but e get cost. The pricing page list the free self-hosted tier as AGPL v3 (GNU Affero General Public License) with up to 3 users. E put SSO (SAML, OIDC and LDAP) together with role based access control for the paid self-hosted tier from $50 per month, as of October 2026. If your plan na "Filestash in front of company SSO, for free", check that page before you design around am.

SFTPGo: protocol server wey get web interface too

SFTPGo na the software wey get the most capability here, and na the one people dey recommend most times for wrong reason. E dey serve SFTP, HTTP/S, FTP/S and WebDAV over local filesystem, encrypted local filesystem, S3 compatible object storage, Google Cloud Storage, Azure Blob Storage, or another SFTP server.

Dem don publish binaries, Debian and Ubuntu packages, plus container image. The current APT repository line and signing key dey for installation page inside SFTPGo documentation. Container route na the fastest way to make am dey run. Replace tag with the version wey you want:

docker run --name some-sftpgo -p 8080:8080 -p 2022:2022 -d "drakkan/sftpgo:tag"

SFTP dey listen on 2022, while the web interfaces dey listen on 8080. Mount /srv/sftpgo as a volume. Otherwise the accounts and their files go disappear when dem recreate the container, because user home directories dey default to /srv/sftpgo/data/<username>.

Two web interfaces dey, and the difference na the part wey most write-ups no explain clearly. WebAdmin, for /web/admin, na for administration. Na there you create users, groups, virtual folders and event rules. You also set quotas, bandwidth limits and access time restrictions there. WebClient, for /web/client, na the end user view. Na there person fit browse files, change their own credentials, set up two factor authentication and create shares.

Those shares na the best feature for this comparison. User fit create HTTP/S links to share files and folders, limit the number of downloads and uploads, protect the share with password, limit access by source IP address, and set automatic expiration date.

So why we dey advise caution? The main focus na the account model and protocol server, not the browsing experience. Choose SFTPGo when other people need real accounts with quotas, when uploads dey arrive over SFTP or FTPS from system wey you no control, or when one bucket need appear inside home directories of several users. Virtual folders handle that last case: folder wey local disk, S3, GCS, Azure Blob, SFTP or HTTP dey back, mounted into multiple accounts, with separate quota for each user on shared folder. If na only browsable page over /srv/files you want, this na plenty machinery for that purpose.

Two more facts dey worth knowing. Community edition na AGPL-3.0-only with additional terms, while commercially licensed Enterprise edition dey available too. OIDC login dey inside the open source build. E maps identity provider users to SFTPGo admins and users for both web interfaces. You fit also turn off the client interface globally with enable_web_client inside httpd configuration. Or you fit do am per user by adding HTTP to that user's denied protocols. This one make the file manager dey available for one person but no dey available for everybody.

Cloud Commander: two panes and a console, for one person

Cloud Commander na MIT licensed Node.js manager wey use two-pane style, with built-in editor and console. Terminal dey as option, but e disabled and no dey installed by default: e need separate gritty package (npm i gritty -g), plus --terminal and --terminal-path options before e fit do anything. Install Cloud Commander globally with npm i cloudcmd -g, or run the published container:

docker run -it --rm -v ~:/root -v /:/mnt/fs -w=/root -p 8000:8000 coderaiser/cloudcmd

Read that command before you run am. -v /:/mnt/fs dey mount the entire host filesystem inside the container, and the sample ~/.cloudcmd.json dey include "root": "/", "auth": false and "console": true. That combination mean say anybody wey reach port 8000 get access to your whole disk and command console for the server. E fit make sense for laptop, but e no good for VPS.

Reduce the scope. The container dey read /root/.cloudcmd.json. The published command provide am by mounting your home directory, so keep the config mount and remove the rest:

docker run -d --name cloudcmd \
  -v ~/.cloudcmd.json:/root/.cloudcmd.json \
  -v /srv/files:/srv/files \
  -w=/srv/files \
  -p 127.0.0.1:8000:8000 \
  coderaiser/cloudcmd

For that config file, set "root" to /srv/files, set "auth" to true with "username" and "password". The file dey store the password as hash, no be plain text. Set "console" to false unless you truly want browser shell access. Leave "terminal" for its default value of false, and skip installing gritty for the same reason. Command line equivalents dey too, including --root, --auth, --username, --password and --prefix.

Make you understand wetin e be. Na one credential pair, with no per-user scoping, no quotas, and no share links. Na personal tool, so bind am to localhost as shown above and reach am through tunnel:

ssh -L 8000:127.0.0.1:8000 you@your-vps

Then open http://127.0.0.1:8000 for your own machine. The file manager no dey exposed publicly. The only thing wey face internet na the SSH daemon wey you already harden for your VPS.

Why Nextcloud no be the correct tool for this one work

Nextcloud na good software, but e no be this one. Na collaboration platform: PHP application, database, background jobs, desktop sync clients and app store. To run am just to get web view of /srv/files na plenty moving parts for small work, and one specific mismatch dey. Nextcloud dey keep file metadata for database table instead of reading directory for every request. So files wey rsync or cron job write fit remain invisible for the interface until scan catch up, with sudo -u www-data php occ files:scan --all. File manager dey list directory when you load page, so that gap no dey.

Keep Nextcloud for wetin e good at: calendars, contacts, sync and sharing with people wey expect desktop client. Nextcloud for VPS with Docker, TLS and backups cover that setup. If you don already dey run am and you only need see existing directory, enable External Storage app and stop there. Another web application wey get write access to the same disk na another thing wey you need patch.

How to run one without giving away the whole server

Never point am go /. The process fit read and write everything wey the user account fit reach. So if person steal session token, e go get exactly that level of filesystem access. Serve only one directory, /srv/files, and create the directory specifically for this purpose.

Run am with non-root user and mount only wetin e dey serve. For Compose, na user: "1000:1000" plus one bind mount for each directory. Add :ro to anything wey e no need write:

    volumes:
      - /srv/files:/folder
      - /srv/media:/media:ro

Usually, after this change, browsing go work but uploads go fail with permission denied. The reason be say the user id inside the container no own the directory outside the container. Compare both sides: docker exec filebrowser id go print the container user, while ls -ln /srv/files go print the numeric owner for the host. Use sudo chown -R 1000:1000 /srv/files to fix am. Na this same ownership problem PUID and PGID for Docker images dey solve.

Bind the published port to localhost, 127.0.0.1:8080:80, instead of 8080:80. Docker dey write its own netfilter rules before ufw rules, so plainly published port fit still dey reachable from internet even when ufw deny 8080 dey active. Put reverse proxy in front for TLS. With plain HTTP, session cookie dey pass through network in clear text, and that cookie na filesystem access. If Compose still new to you, Docker Compose for VPS explain the file layout wey these snippets assume.

Add authentication layer when the application's own authentication too limited. HTTP basic auth for the proxy dey enough for one user instance. Once more than one person dey use am, use OIDC or forward auth against identity provider. That way, revoking one account go revoke access everywhere.

Turn off the extra features. Any file manager wey offers shell, command runner, or in-browser terminal dey offer remote code execution to anybody wey get valid session. FileBrowser guidance say make command runner stay disabled, while Cloud Commander's sample config enables the console. Decide this deliberately; no use the default setting.

Wetin go first spoil, and the errors wey you go see

listen tcp :80: bind: permission denied. Linux dey treat ports below 1024 as privileged: to bind one need root, the CAP_NET_BIND_SERVICE capability, or a lowered net.ipv4.ip_unprivileged_port_start. FileBrowser Quantum documented config dey use port 80. E usually work inside container for standard rootful Docker engine, wey still dey give the container that capability. E go fail when unprivileged user run the binary directly for host, and e fit fail under rootless Docker or stricter capability profile. Set port above 1024 for config.yaml and make the proxy own 443.

Uploads fail while browsing works. To list directory need r-x, but to write inside am need w. The web interface dey show generic error, so check filesystem first instead of application logs.

413 Request Entity Too Large. That error usually come from something wey dey in front of the file manager, not from the file manager itself. Check nginx first. The default client_max_body_size na 1 MB, so proxy go reject bigger upload before the application even see am. Set client_max_body_size 4096m; inside the server block, or use 0 to disable the check. If Cloudflare proxy dey handle the domain, Cloudflare go return the same 413 when request pass the zone maximum upload size, wey the documentation list as 100 MB for Free and Pro plans as of October 2026. Increasing the nginx limit no go help there, so large uploads need route wey no pass through Cloudflare proxy.

Uploaded files carry the wrong group. New files dey belong to the process user, no matter wetin the surrounding directory specify, and this fit stop another service from reading the same tree. Give both services shared group and set setgid bit on the directory with sudo chmod g+s /srv/files, so new files go inherit the directory group.

Everything works on the port and breaks behind the proxy. Application wey dey serve under subpath dey build links from prefix wey you must configure for am. Cloud Commander get --prefix for this. If no such option dey, give the application its own subdomain and proxy the root path.

Which self-hosted file manager you fit run?

  • One VPS, one or two directories, share links wey get expiry, and maybe SSO later: FileBrowser Quantum.
  • Files wey dey somewhere else, an S3 bucket or an SFTP host or a NAS over SMB, and you want one web view across dem: Filestash, as long as you stay within the free tier limits.
  • Other people need accounts, quotas, and uploads over SFTP or FTPS: SFTPGo. Treat the web client as useful extra, no be the main reason you choose am.
  • A personal tool wey get editor and console, accessed through an SSH tunnel and never published: Cloud Commander.
  • Nextcloud already dey run and you get existing directory wey you want expose: the External Storage app, and no new software at all.

Anything you choose, deployment matter pass the choice. Use one directory, a non-root user, a port wey bind to localhost, and authentication for front. File manager wey you set up this way na convenience. The same software wey you point at / with shared password na remote shell with fine interface.

FAQ

FileBrowser safe dey to run for 2026?

The upstream filebrowser/filebrowser README talk say File Browser don archive am on 2026-09-01, and no more releases, bug fixes or security fixes go come. The code still dey run, but unpatched software wey get write access to your filesystem na risk wey dey grow as time dey pass. If you keep am, follow the project own advice: no direct exposure to internet, make reverse proxy handle TLS and its own authentication, leave the command runner disabled, and use unprivileged container wey mount only the directory wey you dey serve. Also note say its sessions na self-contained JWTs instead of server-side identifiers, so you no fit revoke dem, and changing password no invalidate token wey don already issue. For new installation, use the FileBrowser Quantum fork, wey dem publish as the gtstef/filebrowser image, because development still dey continue.

Self-hosted file manager fit use my existing SSO?

FileBrowser Quantum supports OIDC, LDAP and proxy header mode, so e fit sit behind existing identity provider without second user list. SFTPGo's OpenID Connect integration dey inside the open source build, and e maps identity provider users to SFTPGo admins and users for both WebAdmin and WebClient interfaces. Filestash na the exception wey you need watch: its pricing page put SSO (SAML, OIDC and LDAP) for paid self-hosted tier from $50 per month as of October 2026, while the free tier dey listed as AGPL v3 with up to 3 users. When application no get SSO support at all, the fallback na forward authentication for reverse proxy. This one protects the login page, but e no change the application's internal permissions.

SFTPGo get the most complete implementation. User fit create HTTP/S link from WebClient and limit the number of downloads and uploads, set password, restrict access by source IP address, and set automatic expiration date. FileBrowser Quantum supports shares with expiration time. Access fit be anonymous or restricted to one user, plus per-share permissions for viewing, editing and uploading. Filestash get share feature too, and na the only case where server keeps persistent encrypted copy of storage credentials, because the link must work after your browser session don end. Cloud Commander no get share links at all.

E safe to point file manager to / if na only me be the user?

No. The risk no really depend on whether you trust yourself. The process get read and write access to everything wey its user account fit reach. Any path into that session, stolen cookie, unpatched bug for upload handler, or reused password fit become access to /etc, your SSH keys and every service's data directory. Limit the mount to one directory instead: /srv/files rather than /. Cloud Commander na where this problem dey worst, because its published Docker command mounts the host root at /mnt/fs and its sample config sets "root": "/" with "auth": false. Change both before that container listens on anything apart from localhost.

Dis article help you?

#file-manager#filebrowser#sftpgo#self-hosting#storage