Open-source personal finance manager. Self-hosted, privacy-first.
# Required
SECRET_KEY=change-me-in-production
# Public sign-up (optional). Applies until an administrator saves the toggle
# on the admin settings page, whose saved value then wins.
# REGISTRATION_ENABLED=false
# Bank sync: Pluggy (https://pluggy.ai)
## 1. Create an account at https://dashboard.pluggy.ai
## 2. Copy your Client ID and Client Secret
## 3. Add http://localhost:${FRONTEND_PORT}/oauth/callback as an allowed redirect URI
PLUGGY_CLIENT_ID=
PLUGGY_CLIENT_SECRET=
# Bank sync: Enable Banking (https://enablebanking.com) for European banks
## 1. Sign up at https://enablebanking.com and create a Production application
## 2. Add http://localhost:${FRONTEND_PORT}/oauth/callback as an allowed redirect URL
## 3. Save the downloaded PEM file to ./secrets/enable_banking_private.pem
## 4. Copy your Application ID below
ENABLE_BANKING_APP_ID=
# Override only if you put the PEM somewhere other than the default below
# ENABLE_BANKING_PRIVATE_KEY_FILE=/app/secrets/enable_banking_private.pem
# Defaults to ${FRONTEND_URL}/oauth/callback. Set it only when the URL you
# registered in your EB application differs from where the app is served.
# ENABLE_BANKING_OAUTH_REDIRECT_URI=https://securo.example.com/oauth/callback
# OIDC login (optional): Authentik, Pocket ID, or any standard OIDC provider
## Redirect/callback URL to register in the provider:
## http://localhost:${FRONTEND_PORT:-3000}/api/auth/oidc/callback
# OIDC_ENABLED=true
# OIDC_PROVIDER_NAME="My SSO"
# OIDC_DISCOVERY_URL=https://id.example.com/.well-known/openid-configuration
# OIDC_CLIENT_ID=securo
# OIDC_CLIENT_SECRET=your-client-secret
# Quoted on purpose: values with spaces must be quoted for deploy scripts
# that source this file with a shell. Compose and the backend strip the quotes.
# OIDC_SCOPES="openid email profile"
# OIDC_AUTO_REGISTER=true
# OIDC_REQUIRE_VERIFIED_EMAIL=true
# Optional: require OIDC-only login; requires OIDC_ENABLED, OIDC_CLIENT_ID, and OIDC_DISCOVERY_URL
# Disables local login, registration, password reset/change, and new passkey ceremonies
# LOCAL_AUTH_ENABLED=false
# Link an OIDC login to an existing Securo account with the same email:
# disabled (default) never links, verified_email links only when the provider
# sends email_verified=true, email links on a matching email alone.
# OIDC_EXISTING_USER_LINK_MODE=disabled
# Optional: sync Securo admin/workspace roles from OIDC roles/groups
# OIDC_SYNC_ROLES=true
# OIDC_ROLES_CLAIM=groups
# OIDC_ADMIN_ROLES=securo-admins
# OIDC_WORKSPACE_ROLE_MAP={"securo-owners":"owner","securo-editors":"editor","securo-viewers":"viewer"}
# Brazilian Treasury bond lookup (Tesouro Direto). On by default; uncomment to
# disable (e.g. to avoid the dependency on the Brazilian government CSV endpoint).
# TESOURO_DIRETO_ENABLED=false
# Passkeys (optional). Nothing to set for the common cases.
## Passkeys follow the address you open the app on, so they work out of the box on
## http://localhost:3000 and on any HTTPS domain behind a reverse proxy.
##
## Two limits come from the WebAuthn standard itself, not from Securo:
## - an IP address (http://192.168.1.10:3000) can never be used for passkeys
## - plain HTTP can never be used, except on localhost
## Reach the app on a domain over HTTPS, or on http://localhost, to use passkeys.
##
## Set FRONTEND_URL when the app is served from a domain; it is also used for
## CORS and OAuth callbacks.
# FRONTEND_URL=https://securo.example.com
##
## Optional: pin passkeys to a single domain. Leave unset to follow the browser.
## Set it to the parent domain if you reach the app on several subdomains.
# WEBAUTHN_RP_ID=securo.example.com
## Optional: the name shown in the browser's passkey prompt.
# WEBAUTHN_RP_NAME=Securo
# Timezone (optional). Calendar dates follow the timezone saved in Admin
## Settings; without one, this variable, then the host timezone, then UTC.
# TZ=America/Sao_Paulo
# Host ports (optional). Change these to avoid conflicts with other services
## Default values are set in docker-compose.yml and docker-compose.prod.yml.
## Example:
# FRONTEND_PORT=3132
# BACKEND_PORT=8182
# Reverse proxy labels (optional, docker-compose.prod.yml only): static
# Traefik routing labels on the frontend service, for setups (e.g. some
# Coolify versions) where the proxy's own domain UI doesn't turn into
# working Traefik labels on this compose file. Off by default.
# TRAEFIK_ENABLE=true
# FRONTEND_DOMAIN=securo.example.com
## Set to a network name shared by this stack and your Traefik/proxy
## container. Find it with `docker network ls` or `docker inspect
## <traefik-container> --format '{{json .NetworkSettings.Networks}}'`.
## Leave unset to let Traefik auto-detect the shared network; it works as
## long as `frontend` is on exactly one network (the default). REQUIRED if
## you've attached `frontend` to more than one network yourself.
# TRAEFIK_NETWORK=
## Only if your ACME resolver isn't named "letsencrypt".
# TRAEFIK_CERTRESOLVER=letsencrypt
## Must be unique per deployment if multiple Securo instances share the
## same Traefik/Coolify proxy; otherwise their router/service names collide.
# TRAEFIK_RESOURCE_NAME=securo-frontend
# AI Agents (optional). To enable, set BOTH:
# 1) the feature flag
# 2) COMPOSE_PROFILES so `docker compose up` starts the mcp-server container
# (Docker Compose only. On a bare-metal/LXC install set just the flag,
# run `uvicorn mcp_server.main:app --port 8765` next to the API, and set
# AGENTS_BUILTIN_MCP_URL=http://127.0.0.1:8765/mcp)
# AGENTS_ENABLED=true
# COMPOSE_PROFILES=agents
# Public URL external agents use to reach the built-in MCP server, shown in the
# UI token panel. Leave unset to derive it from the browser (host:8765). Set it
# when the MCP server is exposed behind an ingress/reverse proxy on a custom
# host, subpath, or standard 80/443 port instead of :8765.
# AGENTS_EXTERNAL_MCP_URL=https://securo.example.com/mcp