ConfigsApr 16, 2026·3 min read

File Browser — Self-Hosted Web File Manager

File Browser is a lightweight web-based file manager that lets you manage files on your server through a clean browser interface. It supports uploads, downloads, sharing, and user management with no external dependencies.

TL;DR
File Browser provides a clean web UI for managing files on your server with uploads, sharing, and users.
§01

What it is

File Browser is a lightweight, self-hosted web file manager that lets you manage files on your server through a clean browser interface. It supports file uploads, downloads, sharing via links, user management with permissions, and a built-in text editor. No external dependencies are required -- it runs as a single binary.

File Browser is for sysadmins, homelab operators, and teams who need a simple way to manage server files without SSH access or complex NAS software.

The project is actively maintained with regular releases and a growing user community. Documentation covers common use cases, and the open-source nature means you can inspect the source code, contribute fixes, and adapt the tool to your specific requirements.

§02

How it saves time or tokens

Managing files over SSH requires terminal familiarity and is impractical for non-technical users. FTP is insecure and outdated. File Browser provides a modern web UI that anyone can use, with drag-and-drop uploads, file previews, and shareable download links. Installation takes one command.

§03

How to use

  1. Install File Browser with a single curl command or Docker.
  2. Configure the root directory and port.
  3. Access the web UI from your browser.
§04

Example

# One-line install
curl -fsSL https://raw.githubusercontent.com/filebrowser/get/master/get.sh | bash

# Start File Browser
filebrowser -r /path/to/files -p 8080

# Or via Docker
docker run -d --name filebrowser \
  -v /path/to/files:/srv \
  -p 8080:80 \
  filebrowser/filebrowser

# Default credentials: admin / admin
# Open http://localhost:8080
§05

Related on TokRepo

§06

Common pitfalls

  • The default admin password is 'admin'. Change it immediately after first login, especially if the instance is accessible from the internet.
  • File Browser serves files from a root directory. Misconfiguring the root to '/' exposes your entire filesystem. Always set a specific, non-root directory.
  • Large file uploads may fail if your reverse proxy (Nginx) has a low client_max_body_size setting. Increase it to match your expected upload sizes.

Before adopting this tool, evaluate whether it fits your team's existing workflow. Read the official documentation thoroughly, and start with a small proof-of-concept rather than a full migration. Community forums, GitHub issues, and Stack Overflow are valuable resources when you encounter edge cases not covered in the documentation.

Frequently Asked Questions

Does File Browser support user accounts?+

Yes. File Browser supports multiple user accounts with configurable permissions. Each user can have a different root directory and different access levels (view, edit, upload, share, admin).

Can I share files with external users?+

Yes. File Browser lets you create shareable download links for files and folders. Links can have expiration dates and optional passwords for access control.

Does File Browser support file previews?+

Yes. File Browser provides in-browser previews for images, videos, audio files, PDFs, and text files. You can also edit text files directly in the built-in editor.

How lightweight is File Browser?+

File Browser runs as a single Go binary with no external dependencies. It uses minimal memory (typically under 50MB) and can run on Raspberry Pi and other low-resource hardware.

Can I use File Browser behind a reverse proxy?+

Yes. File Browser works behind Nginx, Caddy, Traefik, and other reverse proxies. Configure the base URL path in File Browser settings if you serve it on a subpath.

Citations (3)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets