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 /pdf/{job_id}/download returns 410 Gone

300

INFLUXION_URL_ALLOWLIST

URL prefixes (comma or whitespace separated, e.g. https://storage.example.com/reports/) that templates may load images, stylesheets and fonts from. Scheme, host and port must match exactly and the path is a prefix. Empty allows any http/https URL, none allows no remote URL. data: URLs are always allowed; file: and all other schemes are always refused.

(empty)

INFLUXION_URL_FETCH_MAX_BYTES

Largest decoded size in bytes of one fetched resource, including inline data: URLs. Inline payloads are also bounded before decoding.

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.