https://github.com/hurlenko/filebrowser-docker
🐳 filebrowser inside Docker container
https://github.com/hurlenko/filebrowser-docker
amd64 arm64 armhf docker filebrowser filebrowser-docker raspberrypi
Last synced: 5 months ago
JSON representation
🐳 filebrowser inside Docker container
- Host: GitHub
- URL: https://github.com/hurlenko/filebrowser-docker
- Owner: hurlenko
- Created: 2019-10-16T09:13:10.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-02-01T00:38:44.000Z (8 months ago)
- Last Synced: 2025-04-08T20:17:55.468Z (6 months ago)
- Topics: amd64, arm64, armhf, docker, filebrowser, filebrowser-docker, raspberrypi
- Language: Shell
- Homepage:
- Size: 16.6 KB
- Stars: 330
- Watchers: 6
- Forks: 31
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# [filebrowser](https://github.com/filebrowser/filebrowser) inside a [docker container](https://hub.docker.com/r/hurlenko/filebrowser)
[](https://github.com/hurlenko/filebrowser-docker/releases/latest)
[](https://hub.docker.com/r/hurlenko/filebrowser)
[](https://hub.docker.com/r/hurlenko/filebrowser/)
[](https://hub.docker.com/r/hurlenko/filebrowser/)
## Introduction
filebrowser provides a file managing interface within a specified directory and it can be used to upload, delete, preview, rename and edit your files. It allows the creation of multiple users and each user can have its own directory. It can be used as a standalone app or as a middleware.
## Table of Contents
- [Screenshots](#screenshots)
- [Features](#features)
- [Usage](#usage)
- [Docker](#docker)
- [docker-compose](#docker-compose)
- [Nginx](#running-behind-nginx-proxy)
- [Ports description](#ports-description)
- [Supported environment variables](#supported-environment-variables)
- [Supported volumes](#supported-volumes)
- [Attaching multiple directories](#attaching-multiple-directories)
- [Building](#building)
## Screenshots
### Desktop
### Mobile device
| | |
|---|---|
 | 
## Features
- Confgurable via environment variables
- Can be run using different user
- Supports multiple architectures, tested on Ubuntu 18.04 (`amd64`), Rock64 🍍 (`arm64`) and Raspberry Pi 🍓 (`arm32`)
## Usage
### Docker
```bash
docker run -d --name filebrowser -p 80:8080 hurlenko/filebrowser
```
To run as current user and to map custom volume locations use:
```bash
docker run -d \
--name filebrowser \
--user $(id -u):$(id -g) \
-p 8080:8080 \
-v /DATA_DIR:/data \
-v /CONFIG_DIR:/config \
-e FB_BASEURL=/filebrowser \
hurlenko/filebrowser
```
### docker-compose
Minimal `docker-compose.yml` may look like this:
```yaml
version: "3"
services:
filebrowser:
image: hurlenko/filebrowser
user: "${UID}:${GID}"
ports:
- 443:8080
volumes:
- /DATA_DIR:/data
- /CONFIG_DIR:/config
environment:
- FB_BASEURL=/filebrowser
restart: always
```
Simply run:
```bash
docker-compose up
```
### Running behind Nginx proxy
You can use this nginx config:
```nginx
location /filebrowser {
# prevents 502 bad gateway error
proxy_buffers 8 32k;
proxy_buffer_size 64k;
client_max_body_size 75M;
# redirect all HTTP traffic to localhost:8088;
proxy_pass http://localhost:8080;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#proxy_set_header X-NginX-Proxy true;
# enables WS support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 999999999;
}
```
### Ports description
- `8080` - default filebrowser port
### Supported environment variables
The environment variables are prefixed by `FB_` followed by the option name in caps. So to set "database" via an env variable, you should set FB_DATABASE. The list of avalable options can be [found here](https://filebrowser.org/cli/filebrowser#options).
### Supported volumes
- `/data` - Data directory to browse
- `/config` - `filebrowser.db` location
### Attaching multiple directories
If you want to attach multiple directories you need to mount them as subdirectories of the data directory inside of the container (`/data` by default):
```bash
docker run \
-v /path/to/music:/data/music \
-v /path/to/movies:/data/movies \
-v /path/to/photos:/data/photos \
hurlenko/filebrowser
```
## Building
```bash
git clone https://github.com/hurlenko/filebrowser-docker
cd filebrowser-docker
docker build -t hurlenko/filebrowser .
```