Pass configuration as -e NAME=value flags to docker run. Most variables
have defaults; most deployments only set LICENSE_KEY (and API_KEY when the
endpoint is reachable beyond localhost).
Language support is selected by image tag, not runtime environment. For
example, raccoondata/agent-mask:fr-latest includes French models and preloads
French at startup; multi-latest includes all supported languages and preloads
English and Spanish by default. STARTUP_LANGUAGES can preload languages that
are already included in the selected image; it does not add model files or
enable languages that are absent from that image.
| Variable | Default | Purpose |
|---|
LICENSE_KEY | unset | License key. Without a valid key, mask endpoints return 403 (details) |
API_KEY | unset | When set, the mask endpoints require Authorization: Bearer <API_KEY> (/health, /config, and /license do not require API key authentication) |
| Variable | Default | Purpose |
|---|
PORT | 8000 | HTTP port inside the container |
SYNC_TIMEOUT_SECONDS | 300 | How long POST /mask/sync waits before returning 504 (processing continues; poll GET /mask) |
LOG_LEVEL | INFO | DEBUG, INFO, WARNING, ERROR |
MAX_REQUEST_BODY_SIZE | 1 GB | Reject larger request bodies with 413 |
| Variable | Default | Purpose |
|---|
STARTUP_LANGUAGES | image-dependent | Comma-separated language codes to load immediately at container startup. Values must be languages already included in the selected image; other included languages load on first use. |
