AppFlowy Cloud — Unraid Community Apps Templates

Unraid Community Apps templates for self-hosting AppFlowy Cloud — the open-source, privacy-first collaborative workspace (Notion alternative).

Services

Prerequisites

1. Create the appflowy Docker network

All containers communicate on a shared custom bridge network.

Via SSH or the Unraid terminal:

docker network create appflowy

2. Download the nginx config

Before starting AppFlowy-Nginx, place the custom config at:

/mnt/user/appdata/AppFlowy-Nginx/nginx.conf

mkdir -p /mnt/user/appdata/AppFlowy-Nginx/ssl
curl -o /mnt/user/appdata/AppFlowy-Nginx/nginx.conf \
  https://raw.githubusercontent.com/vmalinics0/unraid-appflowy/main/nginx/nginx.conf

The nginx.conf in this repo uses Unraid container names (AppFlowy-Cloud, AppFlowy-GoTrue, etc.) instead of the default compose service names.

Deploy Order

Deploy containers in this order (each group can be deployed in parallel). The install step number is shown in each app's description in Community Apps.

Step 1 — AppFlowy-Postgres
Step 2 — AppFlowy-Redis
Step 3 — AppFlowy-MinIO
Step 4 — AppFlowy-GoTrue        (waits for Postgres)
Step 5 — AppFlowy-Cloud         (waits for GoTrue, Postgres, Redis, MinIO)
Step 6 — AppFlowy-Admin         \
          AppFlowy-Web            | (wait for AppFlowy-Cloud)
          AppFlowy-Worker         |
          AppFlowy-Search         |
          AppFlowy-AI (optional)  /
Step 7 — AppFlowy-Nginx          (deploy last)

Required Configuration

Set these values consistently across all templates before starting:

Accessing AppFlowy

Native desktop/mobile clients: point them to http://YOUR_SERVER_IP as the server URL.

TLS / HTTPS

Three nginx config files are provided; choose one:

Option A — User-provided certificate

1. Place your certificate and key in /mnt/user/appdata/AppFlowy-Nginx/ssl/:
   • certificate.crt
   • private_key.key
2. Point the AppFlowy-Nginx nginx.conf path to nginx-https-custom.conf.
3. Update all http:// URLs in every template to https://.
4. Update APPFLOWY_WS_BASE_URL in AppFlowy-Web from ws:// to wss://.
5. Restart all containers.

Option B — Automated Let's Encrypt (AppFlowy-Certbot)

Requires a public domain name with port 80 reachable from the internet.

1. Create the required host directories:

   mkdir -p /mnt/user/appdata/AppFlowy-Nginx/letsencrypt
   mkdir -p /mnt/user/appdata/AppFlowy-Nginx/certbot-webroot
   

2. Download nginx-letsencrypt.conf and edit it — replace YOUR_DOMAIN (two occurrences) with your actual domain:

   curl -o /mnt/user/appdata/AppFlowy-Nginx/nginx-letsencrypt.conf \
     https://raw.githubusercontent.com/vmalinics0/unraid-appflowy/main/nginx/nginx-letsencrypt.conf
   

3. Point the AppFlowy-Nginx nginx.conf path to nginx-letsencrypt.conf and restart it.
4. In Community Apps, install AppFlowy-Certbot. Edit its Extra Parameters field — replace yourdomain.com and admin@yourdomain.com with your real values. Start it; it will obtain the certificate and exit (this is normal).
5. Restart AppFlowy-Nginx to load the new certificate.
6. Update all http:// URLs in every template to https:// and APPFLOWY_WS_BASE_URL from ws:// to wss://.
7. Schedule AppFlowy-Certbot to restart monthly (e.g. via the Unraid User Scripts plugin) for automatic renewal. After each renewal, restart AppFlowy-Nginx.

Submitting to Community Apps

1. Fork / create a public GitHub repository.
2. Push all files from this directory into the repo root.
3. Submit the repository URL at https://ca.unraid.net/submit.
4. Run Validate and Scan in the CA submission flow.

Support

• Template issues / requests: https://github.com/vmalinics0/unraid-appflowy/issues
• Template docs: https://github.com/vmalinics0/unraid-appflowy/blob/main/README.md
• Upstream AppFlowy Cloud discussions: https://github.com/AppFlowy-IO/AppFlowy-Cloud/discussions

Upstream

• AppFlowy-Cloud GitHub
• AppFlowy Cloud Discussions