Self-hosting FileBrowser the easy way
Yulei ChenFileBrowser is an open-source, web-based file manager that gives you a clean interface to upload, download, organize, and share files on your server. It's lightweight, fast, and supports multiple users with individual permissions. If you've ever wanted a simple Dropbox-like experience on your own hardware, FileBrowser is a great choice.
Sliplane is a managed container platform that takes the pain out of self-hosting. With one-click deployment, you can get FileBrowser running in minutes - no server setup, no reverse proxy config, no infrastructure headaches.
Prerequisites
Before deploying, ensure you have a Sliplane account (free trial available).
Quick start
Sliplane provides one-click deployment with presets.
Deploy FileBrowser >- Click the deploy button above
- Select a project
- Select a server. If you just signed up you get a 48-hour free trial server
- Click Deploy!
About the preset
The one-click deploy above uses Sliplane's FileBrowser preset. Here's what's included:
- FileBrowser v2.63.2 image (
filebrowser/filebrowser) - check Docker Hub for newer versions - Persistent storage for your managed files (
/srv) and the database (/config) - Pre-configured to listen on
0.0.0.0:80so Sliplane can route traffic to it - Health check on
/for automatic monitoring
Next steps
Once FileBrowser is running on Sliplane, access it using the domain Sliplane provided (e.g. filebrowser-xxxx.sliplane.app).
On first start, FileBrowser creates an admin user with a randomly generated password and prints it to the container logs. To find it, open your service in the Sliplane dashboard and check the logs for a line like:
User 'admin' initialized with randomly generated password: <password>
Use that password to log in, then change it in Settings > User Management.
Managing files
FileBrowser serves files from the /srv directory inside the container. This is mounted to a persistent Sliplane volume, so your files survive container restarts and redeployments. You can upload files through the web UI, create folders, rename, move, and delete files - all from your browser.
User management
FileBrowser supports multiple users with individual permissions. You can create new users, assign them specific home directories within /srv, and control whether they can create, rename, or delete files. Head to Settings > User Management to set this up.
Environment variables
FileBrowser uses command-line flags and a JSON config file rather than environment variables for most settings. The preset passes the necessary flags via the command field. If you need to customize further, you can override the command in the Sliplane service settings. Common flags include:
| Flag | Description |
|---|---|
--root | Root directory to serve (default: /srv) |
--database | Path to the database file |
--address | Listening address (default: 0.0.0.0) |
--port | Listening port (default: 80) |
--baseurl | Base URL path if behind a sub-path |
Logging
FileBrowser logs to STDOUT by default, which works well with Sliplane's built-in log viewer. For general Docker logging tips, check out our post on how to use Docker logs.
Troubleshooting
If you can't log in, make sure the container is healthy in the Sliplane dashboard. Check the logs for any startup errors. If you accidentally locked yourself out, you can redeploy with a fresh database volume - FileBrowser will then re-initialize the admin user and print a new random password to the logs.
Cost comparison
Of course you can also self-host FileBrowser with other cloud providers. Here is a pricing comparison for the most common ones:
| Provider | vCPU Cores | RAM | Disk | Estimated Monthly Cost | Notes |
|---|---|---|---|---|---|
| Sliplane | 2 | 2 GB | 40 GB | €9 | charge per server |
| Render | 1 | 2 GB | 40 GB | ~$35-$45 | VM Small |
| Fly.io | 2 | 2 GB | 40 GB | ~$20-$25 | VM + volume |
| Railway | 2 | 2 GB | 40 GB | ~$15-$66 | Usage-based |
FAQ
What can I use FileBrowser for?
FileBrowser is perfect for managing files on a remote server through a web browser. Common use cases include sharing files with a small team, providing a web UI for server file management, or building a personal cloud storage solution. If you're looking for a full-featured cloud platform with calendar and contacts, consider self-hosting Nextcloud or OpenCloud instead.
Can I use FileBrowser with custom branding?
Yes. FileBrowser supports custom branding through its settings. You can change the instance name, add custom CSS, and set a custom logo. Go to Settings > Global Settings after logging in as admin.
How do I update FileBrowser?
Change the image tag in your Sliplane service settings to the new version and redeploy. Check Docker Hub for the latest stable version. Your files and database are stored in persistent volumes, so they won't be affected by the update.
How do I share files with external users?
FileBrowser has a built-in sharing feature. Select a file or folder, click the share icon, and generate a link. You can set an expiration time and optionally protect the link with a password. The links work without requiring the recipient to have a FileBrowser account.
Can I set storage limits per user?
FileBrowser doesn't have built-in per-user storage quotas. However, you can restrict users to specific directories and control their permissions (create, rename, delete, download, share). For more advanced quota management, consider OpenCloud or Nextcloud.
