https://github.com/outlook84/filebrowser-lean

A lightweight and streamlined Docker image for FileBrowser
https://github.com/outlook84/filebrowser-lean

container docker filebrowser filebrowser-docker

Last synced: 2 months ago
JSON representation

A lightweight and streamlined Docker image for FileBrowser

• Host: GitHub
• URL: https://github.com/outlook84/filebrowser-lean
• Owner: outlook84
• License: apache-2.0
• Created: 2025-07-11T23:45:26.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2026-03-05T11:02:49.000Z (3 months ago)
• Last Synced: 2026-03-05T14:40:20.811Z (3 months ago)
• Topics: container, docker, filebrowser, filebrowser-docker
• Language: Dockerfile
• Homepage:
• Size: 40 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# FileBrowser Lean

A lightweight and streamlined Docker image for [FileBrowser](https://filebrowser.org/), designed for minimal footprint and simplified deployment. This project builds the FileBrowser binary from source and packages it into a tiny busybox-based image.

*   **Minimal Image Size** 

*   **Simplified Configuration:**

  

     No pre-defined user and healthcheck,support passing --config arg for custom config file location.

**This image doesn't have ca-certificates, so you need to a reverse proxy like nginx/caddy for tls support.**

## Usage

Deployment is similar to filebrowser v2.33.0+. There is two differences:

- You don't have to change the permission of two mounted dirs. No more uid/gid mapping issues in rootless environment.

- You can directly pass --config arg to container without overiding the whole entrypoint.

```bash

docker run -d \

  -p 8080:80 \

  -v /path/to/your/files:/srv \

  -v /path/to/your/config_and_db_dir:/config \

  --name filebrowser-lean \

  ghcr.io/outlook84/filebrowser-lean:latest

```

*   Replace `/path/to/your/files` with the absolute path to the directory you want FileBrowser to serve.

*   Replace `/path/to/your/config_and_db_dir` with an absolute path where you want the `settings.json` and `filebrowser.db` (new name for database) to persist. If `settings.json` is not present in this volume, a default one will be created.

### Migrating from Older Versions

If you are migrating from an official `filebrowser/filebrowser` image **older than v2.33.0**, you will need to follow these steps due to breaking changes in how configuration and database files are handled. 

Assume your original configuration file is `.filebrowser.json` and your database is `database.db`.

1.  **Prepare a New Configuration Directory**:

    Create a directory on your host machine to store the new configuration file and database. For example: `mkdir -p /path/to/your/config_and_db_dir`

2.  **Rename and Move Files**:

    -   Rename `.filebrowser.json` to `settings.json`.

    -   Rename `database.db` to `filebrowser.db`.

    -   Move both of these newly named files into the directory you just created (`/path/to/your/config_and_db_dir`).

4.  **Start with the New `docker run` Command above**