Integrations
All integrations can be configured via Portal Config → Integrations or via environment variables. Environment variables seed the database on first startup; once saved through the UI the database value takes precedence.
JIRA
| Env var | Required | Description |
|---|---|---|
JIRA_URL | Yes | Atlassian base URL, e.g. https://acme.atlassian.net |
JIRA_EMAIL | Yes | Service account email |
JIRA_API_TOKEN | Yes | Atlassian API token |
Portal Config tab: Productivity → JIRA
Slack
| Env var | Required | Description |
|---|---|---|
SLACK_BOT_TOKEN | Yes | xoxb-... bot OAuth token |
SLACK_WEBHOOK_URL | No | Incoming webhook for notifications |
SLACK_SCAN_CHANNEL_IDS | No | Comma-separated channel IDs to scan |
SLACK_MENTION_USER_ID | No | User ID to @mention in alerts |
Portal Config tab: Productivity → Slack
n8n
| Env var | Required | Description |
|---|---|---|
N8N_URL | Yes | n8n base URL, e.g. http://n8n:5678 |
N8N_API_KEY | Yes | n8n API key |
Portal Config tab: Productivity → n8n
OpenAI (AI Assistant)
| Env var | Required | Description |
|---|---|---|
OPENAI_API_KEY | Yes | OpenAI API key (sk-...) |
OPENAI_MODEL | No | Model ID, default gpt-4o |
OPENAI_SYSTEM_PROMPT | No | Override the default system prompt |
Portal Config tab: AI
GitHub
| Env var | Required | Description |
|---|---|---|
GITHUB_ORG | Yes | GitHub organization name |
GITHUB_PAT | Yes | Personal access token with repo and read:org scopes |
Portal Config tab: Developer Tools → GitHub
Terraform Cloud
| Env var | Required | Description |
|---|---|---|
TERRAFORM_ORG | Yes | Terraform Cloud organization |
TERRAFORM_API_TOKEN | Yes | Terraform Cloud API token |
TERRAFORM_WORKSPACE_PREFIX | No | Filter workspaces by prefix |
Portal Config tab: Developer Tools → Terraform
ArgoCD
| Env var | Required | Description |
|---|---|---|
ARGOCD_URL | Yes | ArgoCD server URL |
ARGOCD_API_TOKEN | Yes | ArgoCD API token |
Portal Config tab: Observability → ArgoCD
PagerDuty
| Env var | Required | Description |
|---|---|---|
PAGERDUTY_API_KEY | Yes | PagerDuty REST API key |
Portal Config tab: Observability → PagerDuty
Prometheus
| Env var | Required | Description |
|---|---|---|
PROMETHEUS_URL | Yes | Prometheus base URL, e.g. http://prometheus:9090 |
Portal Config tab: Observability → Prometheus
Google Calendar
| Env var | Required | Description |
|---|---|---|
GOOGLE_CALENDAR_ID | Yes | Calendar ID for maintenance events |
GOOGLE_SERVICE_ACCOUNT_JSON | Yes | Service account JSON (base64 or path) |
Portal Config tab: Google Calendar
Cloud Providers
See Cloud & FinOps for AWS, GCP, and Azure env vars.
SMTP (Email)
| Env var | Default | Description |
|---|---|---|
SMTP_HOST | — | SMTP server hostname |
SMTP_PORT | 587 | SMTP port |
SMTP_USER | — | SMTP username |
SMTP_PASSWORD | — | SMTP password |
SMTP_FROM | noreply@devx.local | From address |