FileRise

Overview

FileRise is a lightweight, secure web file manager with uploads, tagging, share links, gallery/table views, and an in-browser editor.

If you change HTTP_PORT / HTTPS_PORT, also edit the corresponding Container Port (Target) in the Port mappings to the same numbers.
Otherwise the container will listen on a different internal port and the WebUI won’t be reachable.

Bridge mode (default): leave defaults (host 8080 → container 80). Access at http://SERVER_IP:8080/.
Custom br0 (own IP): change host ports to 80/443 so you can use http://CONTAINER_IP/ (and https://CONTAINER_IP/ if you actually terminate TLS in-container).

Directions:

UPLOADS PATH: folder where uploaded files are stored. Recommended: use a dedicated folder (e.g. /mnt/user/appdata/FileRise/uploads/), not the root of a huge media share.
USERS_DIR: persistent location for users.txt.
META_DIR: persistent location for metadata JSON files.
SESSIONS_DIR: persistent storage for PHP session files.

Environment Variables:

TIMEZONE: e.g. America/New_York.
DATE_TIME_FORMAT: display format for “Uploaded” and “Modified” (e.g. m/d/y h:iA).
TOTAL_UPLOAD_SIZE: Apache/PHP upload limit (e.g. 5G).
HTTP_PORT / HTTPS_PORT: internal Apache ports. Default 80/443. (If you change these, set the Unraid Container Port fields to the same numbers.)
SHARE_URL: optional, set site root or full endpoint; leave empty to auto-detect.
PERSISTENT_TOKENS_KEY: You can leave blank for pristine installs, or set it if you want to manage the key yourself
PUID / PGID: map www-data to host UID/GID (Unraid: nobody=99, users=100).
SCAN_ON_START: true/false. If true, run a one-shot scan of /var/www/uploads at container start to build the metadata index. Good for first run on an existing folder tree.
CHOWN_ON_START: true/false. If true, recursively chown /var/www/uploads and /var/www/metadata to www-data on startup. Recommended true on first run, then set to false once permissions are correct.
SECURE: true/false; if true, set secure cookies (use with HTTPS).

Ports:

Map a host port to Container Port 80 for HTTP (e.g. Host 8080 → Container 80).
(Optional) Map a host port to Container Port 443 for HTTPS (e.g. Host 8443 → Container 443).
WebUI can be set to http://[IP]:[PORT:80]/ or https://[IP]:[PORT:443]/ accordingly.

More info:
https://github.com/error311/filerise
https://github.com/error311/filerise-docker

Runtime arguments

Web UI: http://[IP]:[PORT:80]/
Network: bridge
Shell: bash
Privileged: false

Template configuration

UPLOADS PATHPathrw

Folder where FileRise stores uploaded files (use a dedicated folder, not the root of a large media share).

Target: /var/www/uploads
Default: /mnt/user/appdata/FileRise/uploads/
Value: /mnt/user/appdata/FileRise/uploads/

USERS_DIRPathrw

Path for persistent users file

Target: /var/www/users
Default: /mnt/user/appdata/FileRise/
Value: /mnt/user/appdata/FileRise/

META_DIRPathrw

Path for persistent metadata JSON files (tags, search index, share links, etc.)

Target: /var/www/metadata
Default: /mnt/user/appdata/FileRise/
Value: /mnt/user/appdata/FileRise/

SESSIONS_DIRPathrw

Path for persistent PHP session data

Target: /var/www/sessions
Default: /mnt/user/appdata/FileRise/sessions/
Value: /mnt/user/appdata/FileRise/sessions/

TIMEZONEVariable

PHP/container timezone, e.g. America/New_York

Value: America/New_York

DATE_TIME_FORMATVariable

Display format for dates (Uploaded/Modified). Defaults to m/d/y h:iA if not set.

Value: m/d/y h:iA

TOTAL_UPLOAD_SIZEVariable

Max total upload size per request (e.g. 5G, 10G). Sets PHP and Apache limits.

Value: 5G

HTTP_PORTVariable

Advanced: internal Apache HTTP listen port (default 80). Leave blank. Only change if you also change the container port target mapping.

HTTPS_PORTVariable

Advanced: internal Apache HTTPS listen port (default 443). Leave blank. Only change if you also change the container port target mapping.

PERSISTENT_TOKENS_KEYVariable

Encrypts stored secrets (tokens, permissions, admin config). Pristine Docker installs auto-generate one. Keep empty to auto generate.

PUIDVariable

Numeric UID to map www-data (Unraid: nobody=99)

Default: 99
Value: 99

PGIDVariable

Numeric GID to map www-data (Unraid: users=100)

Default: 100
Value: 100

SCAN_ON_STARTVariable

true/false. If true, run a one-shot scan of /var/www/uploads on container start to build metadata (good for first run on existing files).

Value: true

CHOWN_ON_STARTVariable

true/false. If true, recursively chown uploads/ and metadata/ to www-data at startup. Recommended true on first run, then false once perms are correct.

Default: true
Value: true

SHARE_URLVariable

Optional. Set to site root or full endpoint; leave empty to auto-detect.

SECUREVariable

true/false. If true, set secure cookies (use when served over HTTPS).

Default: false
Value: false

HTTP PortPorttcp

Host→Container mapping for HTTP

Target: 80
Default: 8080
Value: 8080

HTTPS PortPorttcp

Host→Container mapping for HTTPS

Target: 443
Default: 8443
Value: 8443

LOG_STREAMVariable

Which logs to stream to console: error|access|both|none

Default: error
Value: error

Links

Template Support Docker Hub Project

Details

Repository

error311/filerise-docker:latest

Registry

https://hub.docker.com/r/error311/filerise-docker

Last Updated2026-04-17

First Seen2025-03-26

Run FileRise on Unraid.

FileRise is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS