Reference
Environment variables
Environment defaults shipped in .env.example.
The values below are source defaults/examples, not universal production recommendations. In particular, change
APP_SECRET_KEY and review the network exposure settings.| Variable | Default/example | Area | Notes |
|---|---|---|---|
APP_NAME | Portivo Control Center | Runtime | Runtime configuration value. |
APP_VERSION | 2.0.0 | Runtime | Runtime configuration value. |
APP_HOST | 0.0.0.0 | Network | Runtime configuration value. |
APP_PORT | 8766 | Network | Runtime configuration value. |
APP_SECRET_KEY | CHANGE_THIS_TO_A_LONG_RANDOM_VALUE | Secret / change | Runtime configuration value. |
APP_ADMIN_USERNAME | admin | Runtime | Runtime configuration value. |
PUBLIC_URL_SCHEME | http | Network | APP_ADMIN_PASSWORD is optional and intended only for unattended first boot. Native setup scripts prompt securely and do not retain the clear-text password. Set PUBLIC_URL_SCHEME=https only when users reach Portivo through a trusted TLS reverse proxy. Legacy COOKIE_SECURE values remain supported only when PUBLIC_URL_SCHEME is absent. |
TRUST_PROXY_HEADERS | false | Network | Runtime configuration value. |
TRUSTED_PROXY_IPS | 127.0.0.1,::1 | Network | Runtime configuration value. |
LOGIN_RATE_LIMIT_ENABLED | true | Runtime | Runtime configuration value. |
LOGIN_RATE_LIMIT_WINDOW_SECONDS | 300 | Runtime | Runtime configuration value. |
LOGIN_RATE_LIMIT_MAX_DELAY_SECONDS | 30 | Runtime | Runtime configuration value. |
SSH_CONNECT_TIMEOUT | 12 | Runtime | Runtime configuration value. |
AUTH_CONNECT_TIMEOUT | 2.5 | Runtime | Runtime configuration value. |
AUTH_GLOBAL_TIMEOUT_SECONDS | 5 | Runtime | Runtime configuration value. |
AUTH_MAX_SOURCES | 5 | Runtime | Runtime configuration value. |
SSH_COMMAND_TIMEOUT | 30 | Runtime | Runtime configuration value. |
SSH_CONNECT_RETRIES | 3 | Runtime | Runtime configuration value. |
SSH_RETRY_BACKOFF_SECONDS | 0.75 | Runtime | Runtime configuration value. |
SSH_OPERATION_LOCK_TIMEOUT | 180 | Runtime | Runtime configuration value. |
SSH_POST_SAVE_PROMPT_TIMEOUT | 20 | Runtime | Runtime configuration value. |
SSH_POST_SAVE_COOLDOWN_SECONDS | 2 | Runtime | Runtime configuration value. |
SSH_POST_SAVE_FALLBACK_COOLDOWN_SECONDS | 5 | Runtime | Runtime configuration value. |
SSH_RECENT_AUTH_SUCCESS_WINDOW_SECONDS | 60 | Runtime | Runtime configuration value. |
SSH_RECENT_AUTH_RETRY_DELAY_SECONDS | 2 | Runtime | Runtime configuration value. |
SSH_TERMINAL_IDLE_MINUTES | 15 | Runtime | Runtime configuration value. |
MAX_PARALLEL_SWITCHES | 6 | Runtime | Runtime configuration value. |
FINDER_MAX_PARALLEL_SWITCHES | 12 | Runtime | Runtime configuration value. |
HEALTH_MONITOR_ENABLED | true | Runtime | Runtime configuration value. |
HEALTH_POLL_INTERVAL_SECONDS | 30 | Runtime | Runtime configuration value. |
HEALTH_CONNECT_TIMEOUT | 2 | Runtime | Runtime configuration value. |
HEALTH_MAX_PARALLEL_SWITCHES | 32 | Runtime | Runtime configuration value. |
HEALTH_FIRST_FAILURE_RETRY_SECONDS | 5 | Runtime | Runtime configuration value. |
HEALTH_OFFLINE_POLL_INTERVAL_SECONDS | 60 | Runtime | Runtime configuration value. |
HEALTH_LONG_OFFLINE_AFTER_SECONDS | 900 | Runtime | Runtime configuration value. |
HEALTH_LONG_OFFLINE_POLL_INTERVAL_SECONDS | 120 | Runtime | Runtime configuration value. |
DATABASE_PATH | ./data/portivo.db | Runtime | Runtime configuration value. |
COMMAND_PROFILES_PATH | ./data/command_profiles.json | Runtime | Runtime configuration value. |
ACTION_CATALOG_PATH | ./data/action_catalog.json | Runtime | Runtime configuration value. |