Step-by-step Self Hosting Guides - From Zero to Production Appflowy

Link:https://appflowy.com/docs/Local-Host-Deployment
https://appflowy.com/docs/Step-by-step-Self-Hosting-Guide---From-Zero-to-Production
EM 23/08/2026

In this guide, we will deploy AppFlowy Cloud entirely on local machine. This deployment will not be accessible outside of the machine, and no collaboration is possible. However, it does allow a self hoster to quickly explore the editing functions offered by AppFlowy.

Local Host Deployment

https://youtu.be/V222xugM7oY?si=RIr-rPjkj73Ue0-Q

Prerequisite

Docker compose and Git are installed on your local machine.

Familiarity with command line.

AppFlowy desktop application is already installed.

Setting up the web services

Clone the AppFlowy Cloud repository.

git clone https://github.com/AppFlowy-IO/AppFlowy-Cloud.git

From the root of the directory, copy deploy.env to .env.

cp deploy.env .env

(Optional) If port 80 or 443 are already occupied by another service, such as Nginx, then modify the port binding via the following env variables.

NGINX_PORT=80
NGINX_TLS_PORT=443

Run the services via docker compose, in the background.

docker compose up -d

Check if all services are running and healthy.

docker compose ps

For subsequent sections, we will assume that port 80 is used for the deployment. If you have changed the port in earlier steps, please change the port accordingly.