⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
# General URLs
KANEO_CLIENT_URL=http://localhost:5173
# KANEO_API_URL=http://localhost:1337 # set for host-native API; bundled image derives CLIENT_URL/api
# KANEO_INTERNAL_API_URL=http://127.0.0.1:1337 # optional - internal MCP tool requests only
# CORS_ORIGINS= # optional - comma-separated; defaults to KANEO_CLIENT_URL
# Database
# DATABASE_URL= # optional: use this for host-native or external DB access
POSTGRES_DB=kaneo
POSTGRES_USER=kaneo
POSTGRES_PASSWORD=
# Alternatively, mount a secret file and set POSTGRES_PASSWORD_FILE=/run/secrets/postgres_password
# POSTGRES_HOST=postgres # Compose container default; use localhost for host-native API startup
# POSTGRES_PORT=5432
# DATABASE_POOL_MAX=10 # max connections per API process (min 2); lower it if the DB user has a connection limit
# Note: POSTGRES_DB and POSTGRES_USER alone do not enable derived connection mode.
# Derived DATABASE_URL is only used when POSTGRES_PASSWORD or an explicit host/port is set.
# Redis Pub/Sub for WebSockets (Optional) -> auto fallback to in memory
# Only one mode should be configured. Priority: Cluster > Sentinel > Standalone.
# Standalone
#REDIS_URL=
# Sentinel
#REDIS_SENTINELS=
#REDIS_SENTINEL_MASTER_NAME=mymaster
#REDIS_SENTINEL_PASSWORD=
#REDIS_SENTINEL_TLS=false
# Cluster
#REDIS_CLUSTER_NODES=
# Shared (Sentinel & Cluster)
#REDIS_PASSWORD=
# Authentication
# Generate with: openssl rand -hex 32
# Required for host-native startup. Bundled image generates a temporary one if unset.
# Keep it stable: it protects authentication sessions.
AUTH_SECRET=
# Alternatively, mount a secret file and set AUTH_SECRET_FILE=/run/secrets/auth_secret
# GitHub SSO (Sign in with GitHub, OAuth App)
GITHUB_OAUTH_CLIENT_ID=
GITHUB_OAUTH_CLIENT_SECRET=
# Legacy fallback for SSO (used only if GITHUB_OAUTH_* are unset)
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
# GitHub integration (GitHub App: repository sync, webhooks)
GITHUB_APP_ID=
GITHUB_WEBHOOK_SECRET=
GITHUB_PRIVATE_KEY=
GITHUB_APP_NAME=
# SMTP Configuration
SMTP_HOST=
SMTP_PORT=
SMTP_SECURE=
SMTP_USER=
SMTP_PASSWORD=
SMTP_FROM=
SMTP_REQUIRE_TLS=
# Optional public base URL for email images. Defaults to KANEO_CLIENT_URL/email.
#KANEO_EMAIL_ASSETS_URL=
# When SMTP is configured, sign-in uses email verification codes by default.
# Set to true to use email/password sign-in instead (invitations still use SMTP).
#DISABLE_EMAIL_OTP_SIGN_IN=false
# Cloud-mode abuse mitigations (only enable on hosted multi-tenant instances).
# When KANEO_CLOUD=true: signup with disposable-email providers is blocked,
# guest accounts cannot send workspace invites, and tighter rate limits apply.
# Turnstile verification is controlled separately by TURNSTILE_SECRET_KEY.
#KANEO_CLOUD=false
# Cloudflare Turnstile (authentication CAPTCHA). Set the secret key to enforce;
# leave unset to skip verification (self-hosted).
#TURNSTILE_SECRET_KEY=
# Web container: the production image bakes "KANEO_TURNSTILE_SITE_KEY" as a
# placeholder and apps/web/env.sh substitutes it at container start from this
# env var. For local dev (vite), set VITE_TURNSTILE_SITE_KEY in apps/web/.env.local.
#KANEO_TURNSTILE_SITE_KEY=
# Sentry error tracking (Optional): errors are only reported when a DSN is set
# SENTRY_DSN=
# SENTRY_ENVIRONMENT=production
# SENTRY_TRACES_SAMPLE_RATE=0.1 # 0.0 disables; default 0 (opt-in)
# SENTRY_PROFILES_SAMPLE_RATE=0.1 # 0.0 disables; default 0 (opt-in)
# SENTRY_RELEASE= # git SHA; ties events to source maps. Falls back to package.json version.
# SENTRY_API_TOKEN= # Used by scripts/provision-sentry-alerts.sh and scripts/provision-sentry-dashboards.sh. Scope: org:write. https://sentry.io/settings/account/api/auth-tokens/
# Kaneo Cloud billing via Creem (Optional): only active when KANEO_CLOUD=true
# and both keys are set. Self-hosted installs leave these empty; billing stays off.
# CREEM_API_KEY=
# CREEM_WEBHOOK_SECRET=
# CREEM_TEST_MODE=true # use Creem's sandbox API
# CREEM_PRODUCT_PERSONAL_MONTHLY=
# CREEM_PRODUCT_PERSONAL_ANNUAL=
# CREEM_PRODUCT_TEAM_MONTHLY=
# CREEM_PRODUCT_TEAM_ANNUAL=
# BILLING_TRIAL_DAYS=14
# BILLING_FOUNDING_CUTOFF= # ISO date; workspaces created on/before keep free access
# Private uploads: Silo or another S3-compatible provider (Optional)
# S3_ENDPOINT=https://files.example.com # reachable by the API and browser
# S3_BUCKET=kaneo
# S3_ACCESS_KEY_ID=
# S3_SECRET_ACCESS_KEY=
# S3_REGION=us-east-1
# S3_FORCE_PATH_STYLE=true
# S3_MAX_IMAGE_UPLOAD_BYTES=10485760
# S3_PRESIGN_TTL_SECONDS=300
# S3_KEY_PREFIX=
# Access policy (Optional)
# DISABLE_REGISTRATION=false
# DISABLE_PASSWORD_REGISTRATION=false
# DISABLE_LOGIN_FORM=false
# DISABLE_GUEST_ACCESS=false
# DISABLE_WORKSPACE_CREATION=false
# DEVICE_AUTH_CLIENT_IDS=kaneo-cli,kaneo-mcp
# KANEO_ALLOW_PRIVATE_WEBHOOK_DESTINATIONS=false
# Imports (Optional). Trello Power-Up API key from https://trello.com/power-ups/admin,
# used to link workspace admins to Trello to authorize an import.
# TRELLO_API_KEY=
# Required when saving personal notification tokens or signing secrets. Keep stable.
# NOTIFICATION_SECRET_ENCRYPTION_KEY=