Skip to content

Common Env Variables

Ryan edited this page Dec 22, 2025 · 1 revision

Common environment variables

Variable Required Example What it does
TIMEZONE America/New_York PHP / container timezone.
TOTAL_UPLOAD_SIZE 10G Max total upload size per request (e.g. 5G, 10G). Also used to set PHP upload_max_filesize and post_max_size, and Apache LimitRequestBody.
SECURE false true when running behind HTTPS / a reverse proxy, else false.
PERSISTENT_TOKENS_KEY change_me_super_secret Secret used to sign “remember me”/persistent tokens. Do not leave this at the default.
DATE_TIME_FORMAT Optional Y-m-d H:i Overrides DATE_TIME_FORMAT in config.php (controls how dates/times are rendered in the UI).
SCAN_ON_START Optional true If true, runs scan_uploads.php once on container start to index existing files.
CHOWN_ON_START Optional true If true (default), recursively chowns uploads/, users/, and metadata/ to www-data:www-data on startup. Set to false if you manage ownership yourself.
PUID Optional 99 If running as root, remap www-data user to this UID (e.g. Unraid’s 99).
PGID Optional 100 If running as root, remap www-data group to this GID (e.g. Unraid’s 100).
HTTP_PORT Optional 8080 Override Apache Listen 80 and vhost port with this port inside the container.
HTTPS_PORT Optional 8443 If you terminate TLS inside the container, override Listen 443 with this port.
SERVER_NAME Optional files.example.com Sets Apache’s ServerName (defaults to FileRise if not provided).
LOG_STREAM Optional error Controls which logs are streamed to container stdout: error, access, both, or none.
VIRUS_SCAN_ENABLED Optional true If true, enable ClamAV-based virus scanning for uploads.
VIRUS_SCAN_CMD Optional clamscan Command used to scan files. Can be clamscan, clamdscan, or a wrapper with flags.
CLAMAV_AUTO_UPDATE Optional true If true and running as root, call freshclam on startup to update signatures.
SHARE_URL Optional https://files.example.com Overrides the base URL used when generating public share links (useful behind reverse proxies).

Clone this wiki locally