Public-facing base URL of your AppFlowy instance (e.g. http://192.168.1.100 or https://appflowy.yourdomain.com). No trailing slash.

Target

APPFLOWY_BASE_URL

Default

http://YOUR_SERVER_IP

Value

http://YOUR_SERVER_IP

Shared JWT secret. MUST be identical to GOTRUE_JWT_SECRET in AppFlowy-GoTrue. Keep private.

Target

APPFLOWY_GOTRUE_JWT_SECRET

Default

changeme_jwt_secret_min32chars!!

Value

changeme_jwt_secret_min32chars!!

URL where AppFlowy Web is served. Usually the same as Base URL.

Target

APPFLOWY_WEB_URL

Default

http://YOUR_SERVER_IP

Value

http://YOUR_SERVER_IP

PostgreSQL connection string. Update password and host if changed.

Target

APPFLOWY_DATABASE_URL

Default

postgres://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres

Value

postgres://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres

Redis connection URI.

Target

APPFLOWY_REDIS_URI

Default

redis://AppFlowy-Redis:6379

Value

redis://AppFlowy-Redis:6379

Internal URL of the AppFlowy-GoTrue container on the appflowy network.

Target

APPFLOWY_GOTRUE_BASE_URL

Default

http://AppFlowy-GoTrue:9999

Value

http://AppFlowy-GoTrue:9999

Set true to use MinIO (recommended for self-hosted). Set false to use AWS S3.

Target

APPFLOWY_S3_USE_MINIO

Default

true

Value

true

S3/MinIO access key. Must match AppFlowy-MinIO MINIO_ROOT_USER.

Target

APPFLOWY_S3_ACCESS_KEY

Default

minioadmin

Value

minioadmin

S3/MinIO secret key. Must match AppFlowy-MinIO MINIO_ROOT_PASSWORD.

Target

APPFLOWY_S3_SECRET_KEY

Default

changeme_minio_secret

Value

changeme_minio_secret

S3/MinIO bucket name. Created automatically on first start if APPFLOWY_S3_CREATE_BUCKET=true.

Target

APPFLOWY_S3_BUCKET

Default

appflowy

Value

appflowy

Internal MinIO API URL for container-to-container communication.

Target

APPFLOWY_S3_MINIO_URL

Default

http://AppFlowy-MinIO:9000

Value

http://AppFlowy-MinIO:9000

Public-facing URL for MinIO presigned file access. Clients use this to upload/download files directly.

Target

APPFLOWY_S3_PRESIGNED_URL_ENDPOINT

Default

http://YOUR_SERVER_IP/minio-api

Value

http://YOUR_SERVER_IP/minio-api

Automatically create the S3 bucket on startup if it does not exist.

Target

APPFLOWY_S3_CREATE_BUCKET

Default

true

Value

true

AWS S3 region (e.g. us-east-1). Required only when APPFLOWY_S3_USE_MINIO=false.

Target

APPFLOWY_S3_REGION

Enable permission-based workspace access control. Recommended: true.

Target

APPFLOWY_ACCESS_CONTROL

Default

true

Value

true

PostgreSQL connection pool size. Reduce if your Postgres hits connection limits.

Target

APPFLOWY_DATABASE_MAX_CONNECTIONS

Default

40

Value

40

Max queued WebSocket messages per actor. Higher = more memory; lower may drop messages under load.

Target

APPFLOWY_WEBSOCKET_MAILBOX_SIZE

Default

6000

Value

6000

Restrict signup to whitelisted emails. Requires GOTRUE_DISABLE_SIGNUP=false.

Target

SIGNUP_WHITELIST_ENABLED

Default

false

Value

false

Require admin approval for guest invitations.

Target

GUEST_INVITES_REQUIRE_ADMIN_APPROVAL

Default

false

Value

false

Internal URL for the AppFlowy-Search container.

Target

APPFLOWY_SEARCH_SERVICE_URL

Default

http://AppFlowy-Search:4002

Value

http://AppFlowy-Search:4002

Timeout in seconds for requests to the search service.

Target

APPFLOWY_SEARCH_REQUEST_TIMEOUT_SECS

Default

10

Value

10

Enable AI features. Set false to disable entirely.

Target

AI_ENABLED

Default

true

Value

true

Hostname of the AppFlowy-AI container on the appflowy network.

Target

AI_SERVER_HOST

Default

AppFlowy-AI

Value

AppFlowy-AI

Port of the AI service.

Target

AI_SERVER_PORT

Default

5001

Value

5001

OpenAI API key. Required for AI-powered search summaries and document embeddings. Leave empty to disable AI.

Target

AI_OPENAI_API_KEY

SMTP host for AppFlowy Cloud mailer (e.g. smtp.gmail.com).

Target

APPFLOWY_MAILER_SMTP_HOST

SMTP port.

Target

APPFLOWY_MAILER_SMTP_PORT

Default

465

Value

465

SMTP authentication username.

Target

APPFLOWY_MAILER_SMTP_USERNAME

Sender email address.

Target

APPFLOWY_MAILER_SMTP_EMAIL

SMTP password.

Target

APPFLOWY_MAILER_SMTP_PASSWORD

TLS mode: wrapper (port 465), required, opportunistic, or none.

Target

APPFLOWY_MAILER_SMTP_TLS_KIND

Default

wrapper

Value

wrapper

AssemblyAI API key for voice transcription features. Optional.

Target

ASSEMBLYAI_API_KEY

AssemblyAI REST API base URL.

Target

ASSEMBLYAI_API_BASE

Default

https://api.assemblyai.com/v2

Value

https://api.assemblyai.com/v2

AssemblyAI streaming API base URL.

Target

ASSEMBLYAI_STREAMING_API_BASE

Default

https://streaming.assemblyai.com/v3

Value

https://streaming.assemblyai.com/v3

Rust log level: error, warn, info, debug, trace.

Target

RUST_LOG

Default

info

Value

info

Deployment environment. Keep as production.

Target

APPFLOWY_ENVIRONMENT

Default

production

Value

production