App Configuration Reference

NOTE The application stores all runtime state in a relational database. You may use PostgreSQL or SQLite. An identity provider that supports OpenID‑Connect (OIDC) is required for user authentication and authorization.


1. database

Configures the database connection that the app uses to persist alerts, users, and audit logs.

TOML key Environment variable Type Default Example Notes
connection DEVLENS_DATABASE_CONNECTION string
driver DEVLENS_DATABASE_DRIVER string

2. ai

Settings for the AI‑powered ticket‑fix service.

TOML key Environment variable Type Default Example Notes
host DEVLENS_AI_HOST string
apikey DEVLENS_AI_API_KEY string

3. email

SMTP configuration for sending notification emails.

TOML key Environment variable Type Default Example Notes
host DEVLENS_EMAIL_HOST string
port DEVLENS_EMAIL_PORT int
user DEVLENS_EMAIL_USER string
password DEVLENS_EMAIL_PASSWORD string
from DEVLENS_EMAIL_FROM string
ssl DEVLENS_EMAIL_SSL bool

4. pushover

Push‑notification settings using Pushover.

TOML key Environment variable Type Default Example Notes
token DEVLENS_PUSHOVER_TOKEN string
user DEVLENS_PUSHOVER_USER string

5. slack

Slack webhook configuration.

TOML key Environment variable Type Default Example Notes
token DEVLENS_SLACK_TOKEN string
channel DEVLENS_SLACK_CHANNEL string

6. webhook

Custom HTTP‑endpoint notification.

TOML key Environment variable Type Default Example Notes
url DEVLENS_WEBHOOK_URL string
header_key DEVLENS_WEBHOOK_HEADER_KEY string
header_value DEVLENS_WEBHOOK_HEADER_VALUE string
expected_status DEVLENS_WEBHOOK_EXPECTED_STATUS int

7. pagerduty

PagerDuty integration.

TOML key Environment variable Type Default Example Notes
apikey DEVLENS_PAGERDUTY_API_KEY string

8. oidc

OpenID‑Connect (OIDC) identity‑provider configuration.

TOML key Environment variable Type Default Example Notes
issuer_url DEVLENS_OIDC_ISSUER_URL string
client_id DEVLENS_OIDC_CLIENT_ID string
client_secret DEVLENS_OIDC_CLIENT_SECRET string
redirect_url DEVLENS_OIDC_REDIRECT_URL string

9. web

HTTP/HTTPS front‑end settings.

TOML key Environment variable Type Default Example Notes
domain DEVLENS_WEB_DOMAIN string
https DEVLENS_WEB_HTTPS bool
secret_key DEVLENS_WEB_SECRET_KEY string
no_auth_token DEVLENS_WEB_NO_AUTH_TOKEN string

10. App (top‑level)

Aggregates all configuration sections and runtime state.

Field TOML key / Env Type Default Example Notes
License license / DEVLENS_LICENSE string

Example

license = "ey"

[web]
secret_key = "abc"
domain = "localhost:8000"
https = false
no_auth_token = "foo"

[database]
connection = "/home/demo/devlens.sqlite"
driver = "sqlite"
#connection = "host=localhost user=devlens password=devlens dbname=devlens"
#driver = "postgres"

[oidc]
redirect_url = "http://localhost:8000/auth/oidc/callback"
client_id = "devlens"
client_secret = "abc"
issuer_url = "http://localhost:5556/dex"

[pushover]
token = "abc"
user = "xyz"

[email]
host="mail.tld"
port = 465
user = "devlens-mail"
password = "password"
from = "devlens@mail.tld"
ssl = true

[slack]
token = "asdf"
channel = "notifications"

[webhook]
url = ""
header_key = ""
header_value = ""
ExpectedStatus = 201

[pagerduty]
apikey = "abc"

[ai]
host="http://localhost:8002"
apikey="x"