.env.example

# HTTP
# Host port published by docker-compose (host side of the mapping only —
# inside the container the app always listens on 8080).
JOE_HOST_PORT=8080

# HTTP bind address. Under docker-compose this is pinned to :8080 (see
# docker-compose.yml); only set it when running the binary directly.
# JOE_HTTP_ADDR=:8080

# Database — SQLite (default)
JOE_DB_DRIVER=sqlite3
JOE_DB_DSN=/data/joe-links.db

# Database — PostgreSQL (uncomment and set profile=postgres in docker-compose)
# JOE_DB_DRIVER=postgres
# JOE_DB_DSN=postgres://joe:changeme@postgres:5432/joe_links?sslmode=disable

# Database — MySQL
# JOE_DB_DRIVER=mysql
# JOE_DB_DSN=joe:changeme@tcp(mysql:3306)/joe_links?parseTime=true

# OIDC Authentication
JOE_OIDC_ISSUER=             # OIDC provider discovery URL, e.g. https://accounts.google.com
JOE_OIDC_CLIENT_ID=          # OAuth2 client ID
JOE_OIDC_CLIENT_SECRET=      # OAuth2 client secret
JOE_OIDC_REDIRECT_URL=       # Callback URL, e.g. https://go.example.com/auth/callback

# OIDC groups claim to read group membership from (default: groups)
# JOE_OIDC_GROUPS_CLAIM=groups

# Admin
JOE_ADMIN_EMAIL=             # Email address granted admin role on first login

# Comma-separated OIDC group names that also grant the admin role
# JOE_OIDC_ADMIN_GROUPS=admins,sre

# Session
JOE_SESSION_LIFETIME=720h    # Session absolute expiry (default: 30 days)

# Disable the Secure flag on session/auth cookies so login works over plain
# HTTP. Local development only — never enable in production. (default: false)
# JOE_INSECURE_COOKIES=true

# Short-link keyword prefix shown in the UI, e.g. "go". Defaults to the
# first DNS label of the request host.
# JOE_SHORT_KEYWORD=go

# LLM slug suggestions (optional — leave JOE_LLM_PROVIDER unset to disable)
# JOE_LLM_PROVIDER=          # "anthropic", "openai", or "openai-compatible"
# JOE_LLM_API_KEY=           # API key for the chosen provider
# JOE_LLM_MODEL=             # Model override (defaults: claude-haiku-4-5-20251001 / gpt-4o-mini)
# JOE_LLM_BASE_URL=          # Base URL for openai-compatible providers (default: https://api.openai.com)
# JOE_LLM_PROMPT=            # Custom prompt template text (overrides the built-in default)