Environment Variables
Influxion uses environment variables for configuration. You can set these variables
individually in your shell (e.g., export VAR=value) or place them in a .env file
at the project root (a stub .env file is provided).
Variable |
Description |
Default |
|---|---|---|
INFLUXION_DATABASE_URL |
Database URL for SQLModel |
sqlite:///./influxion.db |
INFLUXION_DB_ECHO |
Echo SQL statements when truthy |
(empty) |
INFLUXION_USE_CELERY |
Enable Celery for background PDF generation |
(empty) |
INFLUXION_CELERY_BROKER_URL |
Celery broker URL |
amqp://guest@localhost// |
INFLUXION_CELERY_RESULT_BACKEND |
Celery result backend URL |
rpc:// |
INFLUXION_PDF_RUNTIME_DIR |
Runtime directory for short-lived generated PDF files. PDF bytes are written here, not to the database. |
/run/influxion/pdfs |
INFLUXION_PDF_RETENTION_SECONDS |
Seconds a completed PDF remains downloadable before |
300 |
INFLUXION_URL_ALLOWLIST |
URL prefixes (comma or whitespace separated, e.g. |
(empty) |
INFLUXION_URL_FETCH_MAX_BYTES |
Largest decoded size in bytes of one fetched resource, including inline |
20971520 |
INFLUXION_URL_FETCH_TIMEOUT |
Positive, finite socket timeout in seconds for HTTP resource fetching; not a total rendering deadline |
10 |
INFLUXION_VAULT_URL |
Azure Key Vault URL for signing certificates |
(empty) |
INFLUXION_AZURE_TENANT_ID |
Azure tenant (directory) ID |
(empty) |
INFLUXION_AZURE_API_CLIENT_ID |
Azure application (client) ID (used by the service) |
(empty) |
INFLUXION_AZURE_API_CLIENT_SECRET |
Azure client secret (used by the service) |
(empty) |
INFLUXION_AZURE_AUDIENCE |
Application (client) ID URI of the Influxion API (audience) |
(empty) |
INFLUXION_AZURE_DEFAULT_SCOPE |
Default OAuth2 scope for Influxion API (e.g., api://<client-id>/.default) |
(empty) |
INFLUXION_CLIENT_ID |
Client credential ID for scripts calling the API |
(empty) |
INFLUXION_CLIENT_SECRET |
Client credential secret for scripts calling the API |
(empty) |
Resource fetching
HTTP resources support uncompressed and streaming gzip responses. Deflate and other content encodings are refused before decompression to avoid unbounded memory allocation. The size limit applies per resource, not to a whole job.
Both Compose configurations forward the three INFLUXION_URL_* settings from
the shell or project .env file to the app and workers. For example,
INFLUXION_URL_ALLOWLIST=none disables remote fetching while retaining inline
resources within the size limit. An empty allowlist permits arbitrary HTTP(S)
destinations, including private networks.
For Helm, configure urlFetch.allowlist, urlFetch.maxBytes and
urlFetch.timeout. The chart supplies the same policy to the app and every
worker, including when worker.enabled=false runs rendering in the app.