Skip to content

Environment Variables

Core runtime

VariableDefault
ZEPTOZ_PROJECT_NAMEno default
ZEPTOZ_RUNTIME_ENVno default
ZEPTOZ_DATABASE_URLno default (required)
ZEPTOZ_PATHS_HOOKSno default
ZEPTOZ_PATHS_STORAGEno default
ZEPTOZ_SERVER_HOSTno default
ZEPTOZ_SERVER_PORTno default

Canonical config file is zeptoz.toml (database.url field).

Auth

VariableDefault
ZEPTOZ_AUTH_JWT_SECRETno default (required)
ZEPTOZ_AUTH_ENCRYPTION_KEYderived from ZEPTOZ_AUTH_JWT_SECRET when unset
ZEPTOZ_AUTH_ACCESS_TTL_MINUTES15
ZEPTOZ_AUTH_REFRESH_TTL_DAYS30
ZEPTOZ_AUTH_COOKIE_SECUREfalse

Hook limits

VariableDefault
ZEPTOZ_HOOK_TIMEOUT_MS150
ZEPTOZ_HOOK_MAX_STEPS100000
ZEPTOZ_HOOK_MEMORY_BYTES8388608
ZEPTOZ_HOOK_CAPABILITY_PROFILEdefault