Skip to content

TaskView is a self-hosted project and task management platform focused on clarity, ownership, and control. TaskView is built for teams that want a transparent, self-hosted alternative to SaaS task managers.

5.3 KB
Raw Blame
# Node Environment
NODE_ENV=development
# Log level: fatal, error, warn, info, debug, trace or silent (default: info in production, debug otherwise)
# LOG_LEVEL=info

# Database Configuration
DB_HOST=localhost
DB_USER=postgres
DB_PASSWORD=your_password_here
DB_NAME=tv_3_dev_db
DB_PORT=5432

# Application
APP_PORT=1401
APP_URL=http://localhost:3000
API_URL=http://localhost:1401

# JWT Configuration
JWT_SIGN=your_jwt_secret_here
ACCESS_LIFE_TIME=1d
REFRESH_LIFE_TIME=2d
JWT_ALG=HS256
# Max sign-in codes one account can request by email per hour (default 5)
# LOGIN_CODE_HOURLY_LIMIT=5
# Days a sign-in session lasts, however often its tokens are refreshed (default 90)
# SESSION_MAX_AGE_DAYS=90
# Let users delete their own account (default false: on a company install an admin removes accounts)
# ALLOW_ACCOUNT_DELETION=false

# SSO: comma-separated email domains that skip DNS/HTTP ownership proof (air-gapped installs)
#SSO_TRUSTED_DOMAINS=company.com,corp.local

# OAuth 2.1 for third-party MCP clients (ChatGPT, Claude connectors).
# Dynamic Client Registration is OFF unless you set this to true. Cloud clients
# cannot connect without it: they have no way to pre-register with your
# instance, so enable it if you want ChatGPT or Claude to connect over OAuth.
# Leave it unset on a private install that only uses manually seeded clients.
#OAUTH_DYNAMIC_REGISTRATION=true
# Public URL of this API. Used as the OAuth issuer in the discovery documents,
# so it must be the URL clients actually reach — set it behind a proxy.
#API_PUBLIC_URL=https://api.taskview.tech

# SMTP Configuration
SMTP_HOST=smtp.domain.com
SMTP_PORT=465
[email protected]
SMTP_PASSWORD=your_smtp_password_here
SMTP_ENCRYPTION=ssl
SMTP_FROM_NAME=TaskView
[email protected]
# Email a person when they are invited to a project (requires SMTP)
INVITE_EMAIL_ENABLED=false
# Max invite emails one user may trigger per hour (default 30)
# INVITE_EMAIL_HOURLY_LIMIT=30

# Outgoing webhooks may only target public addresses: loopback, private (10/8,
# 172.16/12, 192.168/16), link-local and cloud-metadata ranges are refused, both
# when a webhook is saved and on every delivery. Set to true on a self-hosted
# install whose receivers (n8n, CI, internal bots) live on the same private
# network. Never enable this on a public multi-tenant instance.
#WEBHOOKS_ALLOW_PRIVATE_URLS=false

# Encryption (32-byte hex key for AES-256-GCM)
# Generate a key: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
ENCRYPTION_KEY=

# GitHub Integration OAuth (separate from login OAuth)
GITHUB_INTEGRATION_CLIENT_ID=
GITHUB_INTEGRATION_CLIENT_SECRET=
GITHUB_INTEGRATION_CALLBACK_URL=http://localhost:1401/module/integrations/oauth/github/callback
# For GitHub Enterprise, override these:
# GITHUB_BASE_URL=https://github.yourcompany.com
# GITHUB_API_URL=https://github.yourcompany.com/api/v3

# GitLab Integration OAuth
GITLAB_INTEGRATION_CLIENT_ID=
GITLAB_INTEGRATION_CLIENT_SECRET=
GITLAB_INTEGRATION_CALLBACK_URL=http://localhost:1401/module/integrations/oauth/gitlab/callback
# For self-hosted GitLab, override these:
# GITLAB_BASE_URL=https://gitlab.yourcompany.com
# GITLAB_API_URL=https://gitlab.yourcompany.com/api/v4

# Gitea Integration OAuth
GITEA_INTEGRATION_CLIENT_ID=
GITEA_INTEGRATION_CLIENT_SECRET=
GITEA_INTEGRATION_CALLBACK_URL=http://localhost:1401/module/integrations/oauth/gitea/callback
# For self-hosted Gitea, override these:
# GITEA_BASE_URL=https://gitea.yourcompany.com
# GITEA_API_URL=https://gitea.yourcompany.com/api/v1

# Firebase Cloud Messaging (push notifications for mobile, optional)
# Path to Firebase service account JSON file
# FIREBASE_CREDENTIALS_PATH=./firebase-credentials.json

# Analytics (optional)
# Comma-separated list of section IDs to enable in the analytics page.
# When unset, all sections are available. When set, only the listed IDs are
# available — in the order they appear here.
# Example:
# ANALYTICS_SECTIONS=kpi.total_income,kpi.total_expense,chart.income_expense_month,chart.income_expense_per_project

# Centrifugo (real-time notifications, optional)
# CENTRIFUGO_API_URL=http://localhost:8000
# CENTRIFUGO_API_KEY=your_centrifugo_api_key_here
# CENTRIFUGO_TOKEN_SECRET=your_centrifugo_token_secret_here
# Public port that clients use to connect to Centrifugo (exposed port, not internal docker port)
# CENTRIFUGO_PUBLIC_PORT=8000

# Files (task attachments)
# Attachments are disabled until FILE_STORAGE_PROVIDER names a provider AND that provider is fully configured:
# local needs FILE_STORAGE_LOCAL_DIR (mount it as a volume in Docker), s3 needs the FILE_STORAGE_S3_* variables below.
# Both providers may be configured at once; FILE_STORAGE_PROVIDER is the one new uploads go to.
# FILE_STORAGE_PROVIDER=local
# FILE_MAX_SIZE_MB=10
# FILE_STORAGE_LOCAL_DIR=./data/files
# FILE_STORAGE_S3_BUCKET=taskview
# FILE_STORAGE_S3_REGION=us-east-1
# FILE_STORAGE_S3_ENDPOINT=http://localhost:9000
# FILE_STORAGE_S3_ACCESS_KEY=
# FILE_STORAGE_S3_SECRET_KEY=
# FILE_STORAGE_S3_FORCE_PATH_STYLE=true
# Storage quotas: enforce (default, reject uploads over the quota) or off.
# Every organization gets FILE_QUOTA_ORGANIZATION_MB unless tv_auth.organizations.file_quota_mb sets its own value.
# FILE_QUOTA_MODE=enforce
# FILE_QUOTA_ORGANIZATION_MB=100

# SSO: allow the server to fetch IdP metadata from private addresses (self-hosted IdP on the internal network)
# SSO_ALLOW_PRIVATE_URLS=false