Environment Variables
Core runtime
| Variable | Required | Default |
|---|---|---|
ZEPTOZ_PROJECT_NAME | No | zeptoz-app |
ZEPTOZ_RUNTIME_ENV | No | dev |
ZEPTOZ_RELATION_INFER_FROM_ID_FIELDS | No | false |
ZEPTOZ_DATABASE_URL | No | sqlite://./data/zeptoz.sqlite?mode=rwc |
ZEPTOZ_PATHS_DB | No | ./data/zeptoz.sqlite |
ZEPTOZ_PATHS_HOOKS | No | ./hooks |
ZEPTOZ_PATHS_STORAGE | No | ./storage |
ZEPTOZ_SERVER_HOST | No | 127.0.0.1 |
ZEPTOZ_SERVER_PORT | No | 8787 |
Canonical config file is zeptoz.toml (database.url field).
Auth
| Variable | Required | Default |
|---|---|---|
ZEPTOZ_AUTH_JWT_SECRET | No | dev-secret-change-me |
ZEPTOZ_AUTH_ENCRYPTION_KEY | No | derived from ZEPTOZ_AUTH_JWT_SECRET when unset |
ZEPTOZ_AUTH_ACCESS_TTL_MINUTES | No | 15 |
ZEPTOZ_AUTH_REFRESH_TTL_DAYS | No | 30 |
ZEPTOZ_AUTH_COOKIE_SECURE | No | false |
Hook limits
| Variable | Required | Default |
|---|---|---|
ZEPTOZ_HOOK_TIMEOUT_MS | No | 150 |
ZEPTOZ_HOOK_MAX_STEPS | No | 100000 |
ZEPTOZ_HOOK_MEMORY_BYTES | No | 8388608 |
ZEPTOZ_HOOK_CAPABILITY_PROFILE | No | default |