AppFlowy-AI

Overview

Step 6/7 (optional): AppFlowy AI — optional Python service providing LLM-powered chat, document summarisation, and embedding generation for AppFlowy Cloud. Requires an OpenAI or Azure OpenAI API key. Part of the AppFlowy Cloud stack.

Requirements

Custom Docker network named "appflowy" must exist before deploying any container in this stack. Create it via SSH or the Unraid terminal: docker network create appflowy — Network Type is pre-set to "appflowy" by default, verify it is selected.

Runtime arguments

Network: custom:appflowy
Shell: sh
Privileged: false

Template configuration

OpenAI API KeyVariable

OpenAI API key. Required unless using Azure OpenAI. Used for chat and embeddings.

Target: OPENAI_API_KEY

Azure OpenAI API KeyVariable

Azure-hosted OpenAI API key. Use this instead of OPENAI_API_KEY for Azure deployments.

Target: AZURE_OPENAI_API_KEY

Azure OpenAI EndpointVariable

Azure OpenAI resource endpoint URL (e.g. https://my-resource.openai.azure.com/).

Target: AZURE_OPENAI_ENDPOINT

Azure OpenAI API VersionVariable

Azure OpenAI API version string (e.g. 2024-02-01).

Target: AZURE_OPENAI_API_VERSION

AppFlowy Host (Base URL)Variable

Public-facing base URL. Must match APPFLOWY_BASE_URL in AppFlowy-Cloud.

Target: AI_APPFLOWY_HOST
Default: http://YOUR_SERVER_IP
Value: http://YOUR_SERVER_IP

JWT SecretVariable

Shared JWT secret. Must be identical to GoTrue and AppFlowy-Cloud.

Target: APPFLOWY_GOTRUE_JWT_SECRET
Default: changeme_jwt_secret_min32chars!!
Value: changeme_jwt_secret_min32chars!!

Database URLVariable

PostgreSQL connection string for the AI service (uses psycopg driver syntax).

Target: AI_DATABASE_URL
Default: postgresql+psycopg://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres
Value: postgresql+psycopg://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres

Redis URLVariable

Redis connection URL.

Target: AI_REDIS_URL
Default: redis://AppFlowy-Redis:6379
Value: redis://AppFlowy-Redis:6379

Use MinIOVariable

Set true to use MinIO.

Target: AI_USE_MINIO
Default: true
Value: true

S3 Access KeyVariable

S3/MinIO access key.

Target: APPFLOWY_S3_ACCESS_KEY
Default: minioadmin
Value: minioadmin

S3 Secret KeyVariable

S3/MinIO secret key.

Target: APPFLOWY_S3_SECRET_KEY
Default: changeme_minio_secret
Value: changeme_minio_secret

S3 BucketVariable

S3/MinIO bucket name.

Target: APPFLOWY_S3_BUCKET
Default: appflowy
Value: appflowy

S3 RegionVariable

AWS S3 region (leave empty for MinIO).

Target: APPFLOWY_S3_REGION

MinIO URL (internal)Variable

Internal MinIO API URL.

Target: AI_MINIO_URL
Default: http://AppFlowy-MinIO:9000
Value: http://AppFlowy-MinIO:9000

AI Server PortVariable

Port the AI service listens on. Must match AI_SERVER_PORT in AppFlowy-Cloud.

Target: AI_SERVER_PORT
Default: 5001
Value: 5001

Default AI ModelVariable

Default OpenAI chat model (e.g. gpt-4.1-mini, gpt-4o). Must be available in your OpenAI account.

Target: DEFAULT_AI_MODEL
Default: gpt-4.1-mini
Value: gpt-4.1-mini

Default Completion ModelVariable

Model used for completions/summaries.

Target: DEFAULT_AI_COMPLETION_MODEL
Default: gpt-4.1-mini
Value: gpt-4.1-mini

Links

Template Support Docker Hub Project

Details

Repository

appflowyinc/appflowy_ai:latest

Registry

https://hub.docker.com/r/appflowyinc/appflowy_ai

Last Updated2026-05-22

First Seen2026-05-26

Run AppFlowy-AI on Unraid.

AppFlowy-AI is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS