Cliparr only needs a few settings in production: a stable APP_KEY and a persistent data directory.
| Variable | Description | Default |
|---|---|---|
| APP_KEY | Required secret for credential encryption. Must be at least 32 characters long. Required | - |
| PORT | Internal port for the Express server. | 3000 |
| CLIPARR_DATA_DIR | Directory for SQLite storage. | /data |
| CLIPARR_LOG_LEVEL | Server log level. Supports trace, debug, info, warning, error, and fatal. Defaults to debug in development and info in production. | debug/info |
| CLIPARR_LOG_FORMAT | Production server console log format. Development console logs are always JSON. | json dev / pretty prod |
| CLIPARR_LOG_FILE | Optional path for a rotating server log file. Relative paths resolve from the server working directory. | - |
| CLIPARR_LOG_FILE_FORMAT | Optional log file format. Defaults to CLIPARR_LOG_FORMAT when set, otherwise json. | json |
| CLIPARR_LOG_FILE_MAX_SIZE | Maximum size for each rotating server log file. Supports kb, mb, and gb suffixes. | 10mb |
| CLIPARR_LOG_FILE_MAX_FILES | Total number of rotating server log files to keep, including the active file. | 5 |
| CLIPARR_ALLOW_LOOPBACK_JELLYFIN_URLS | Allow Jellyfin URLs that resolve to localhost or loopback. Use only for trusted self-hosted setups. | false |
Reverse proxies
When running behind Caddy, Nginx, Traefik, or another reverse proxy, preserve the Host header and pass X-Forwarded-Proto. Cliparr trusts loopback, link-local, and private-LAN proxy ranges directly in the app, so typical same-network proxy setups do not need extra app configuration.
HTTPS and browser APIs
The editor uses browser WebCodecs. Supporting browsers require a secure context, which means HTTPS in production. Local development on localhost and 127.0.0.1 also counts as secure for this browser requirement.
Data directory
The default container data directory is /data. In production, mount that path to a volume so SQLite state and encrypted provider credentials survive updates.
For diagnostics and file log settings, see Logging. For tags embedded into exported clips, see Export metadata.