Skip to main content
Every CLI flag has a corresponding environment variable. Flags take precedence when both are set.

General

VariableDefaultDescription
SCREENJSON_ENCRYPT_KEYDefault encryption / decryption key. Used by encrypt, decrypt, convert --encrypt, export --decrypt.
SCREENJSON_PDFTOHTML/opt/homebrew/bin/pdftohtmlPath to Poppler’s pdftohtml binary.
SCREENJSON_PDF_PAPERletterDefault paper size for PDF export: letter · a4.
SCREENJSON_PDF_FONTcourierDefault font for PDF export: courier · courier-prime.

Server

Used by screenjson serve.
VariableDefaultDescription
SCREENJSON_SERVER_HOST0.0.0.0Listen host.
SCREENJSON_SERVER_PORT8080Listen port.
SCREENJSON_SERVER_WORKERSCPU coresWorker pool size.

External services

VariableDefaultDescription
SCREENJSON_GOTENBERG_URLGotenberg URL for HTML→PDF rendering.
SCREENJSON_TIKA_URLApache Tika URL for content extraction.
SCREENJSON_LLM_URLOpenAI-compatible LLM endpoint.
SCREENJSON_LLM_APIKEYLLM API key.
SCREENJSON_LLM_MODELModel identifier.

Database

Used by convert --db ....
VariableDescription
SCREENJSON_DB_TYPEelasticsearch · mongodb · cassandra · dynamodb · redis.
SCREENJSON_DB_HOSTHost.
SCREENJSON_DB_PORTPort.
SCREENJSON_DB_USERUsername.
SCREENJSON_DB_PASSPassword.
SCREENJSON_DB_COLLECTIONCollection or index name.
SCREENJSON_DB_AUTH_TYPEbasic · apikey · token.
SCREENJSON_DB_APIKEYAPI key (when auth_type = apikey).
SCREENJSON_DB_INDEXElasticsearch index name.
SCREENJSON_DB_REGIONDynamoDB region.

Blob storage

Used by convert --blob ....
VariableDescription
SCREENJSON_BLOB_TYPEs3 · azure · minio.
SCREENJSON_BLOB_BUCKETBucket name.
SCREENJSON_BLOB_KEYObject key / path.
SCREENJSON_BLOB_REGIONAWS region.
SCREENJSON_BLOB_ENDPOINTCustom endpoint (MinIO).
SCREENJSON_AWS_ACCESS_KEYAWS access key ID.
SCREENJSON_AWS_SECRET_KEYAWS secret access key.