AppFlowy-Search

Overview

Step 6/7: AppFlowy Search — full-text and semantic (AI-powered) search service for AppFlowy Cloud documents. 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: bash
Privileged: false

Template configuration

Keyword Index DirectoryPathrw

Persistent directory for the full-text (keyword) search index. Must have sufficient free space.

Target: /var/lib/appflowy/keyword_index
Default: /mnt/user/appdata/AppFlowy-Search/keyword_index
Value: /mnt/user/appdata/AppFlowy-Search/keyword_index

Database URLVariable

PostgreSQL connection string. Must match AppFlowy-Cloud.

Target: APPFLOWY_SEARCH_DATABASE_URL
Default: postgres://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres
Value: postgres://postgres:changeme_strong_password@AppFlowy-Postgres:5432/postgres

Redis URLVariable

Redis connection URL.

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

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!!

Use MinIOVariable

Set true to use MinIO.

Target: APPFLOWY_S3_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

MinIO URL (internal)Variable

Internal MinIO API URL.

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

S3 RegionVariable

AWS S3 region (leave empty for MinIO).

Target: APPFLOWY_S3_REGION

OpenAI API KeyVariable

OpenAI API key for semantic/vector search and document embeddings. Leave empty to use keyword-only search.

Target: AI_OPENAI_API_KEY

Azure OpenAI API KeyVariable

Azure-hosted OpenAI API key (alternative to OpenAI). Leave empty if using standard OpenAI.

Target: AZURE_OPENAI_API_KEY

Azure OpenAI EndpointVariable

Azure OpenAI resource endpoint URL.

Target: AZURE_OPENAI_ENDPOINT

Azure OpenAI API VersionVariable

Azure OpenAI API version string.

Target: AZURE_OPENAI_API_VERSION

Keyword Search EnabledVariable

Enable full-text keyword search. Recommended: true.

Target: APPFLOWY_KEYWORD_SEARCH_ENABLED
Default: true
Value: true

Background Indexer EnabledVariable

Continuously index new/updated documents in the background.

Target: APPFLOWY_BACKGROUND_INDEXER_ENABLED
Default: true
Value: true

Keyword Worker EnabledVariable

Enable the keyword indexing worker.

Target: APPFLOWY_KEYWORD_WORKER_ENABLED
Default: true
Value: true

Database Indexer EnabledVariable

Enable database-level indexing (experimental).

Target: APPFLOWY_INDEXER_DATABASE_ENABLED
Default: false
Value: false

Keyword Index Map Size (bytes)Variable

Memory-mapped file size for keyword index in bytes. Default: 2 GiB. Reduce if RAM is limited.

Target: APPFLOWY_KEYWORD_INDEX_MAP_SIZE_BYTES
Default: 2147483648
Value: 2147483648

Listen HostVariable

IP address the search service listens on. :: = all interfaces.

Target: APPFLOWY_SEARCH_HOST
Default: ::
Value: ::

Listen PortVariable

Port the search service listens on (internal).

Target: APPFLOWY_SEARCH_PORT
Default: 4002
Value: 4002

Log LevelVariable

Rust log level.

Target: RUST_LOG
Default: info
Value: info

Links

Template Support Docker Hub Project

Details

Repository

appflowyinc/appflowy_search:latest

Registry

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

Last Updated2026-05-25

First Seen2026-05-26

Run AppFlowy-Search on Unraid.

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

Explore Unraid OS