AppFlowy Cloud em Docker com Autenticação GitHub

O AppFlowy é uma alternativa de código aberto ao Notion, com foco em privacidade, controle local e extensibilidade. Diferente de soluções SaaS que prendem seus dados em servidores de terceiros, o AppFlowy te dá controle total, perfeito para quem preza por segurança e personalização.

Se você quer criar seu próprio ambiente de produtividade colaborativa, com controle sobre onde os dados são salvos e liberdade para adaptar conforme sua stack, o AppFlowy é uma excelente escolha.

O AppFlowy Cloud é a versão em container da ferramenta, que facilita a instalação e escalabilidade usando Docker. Ideal para quem quer subir o AppFlowy de forma rápida, com suporte a múltiplos usuários e autenticação via provedores como GitHub, Google e Discord.

🌐 Por que configurar um DNS personalizado?

Ao invés de acessar o sistema via IP ou porta (ex: http://192.168.0.15:8048), configurar um domínio como https://appflowy.seudominio.com.br torna o acesso mais simples, profissional e fácil de lembrar. Isso também facilita a integração com SSL e autenticação OAuth.

Você pode configurar esse DNS com um subdomínio (como appflowy.seudominio.com.br) apontando para o IP do seu servidor via A record, e utilizar ferramentas como Nginx Proxy Manager ou Cloudflare Tunnel para lidar com certificados SSL automaticamente.

⚠️ Esse passo é opcional, mas altamente recomendado!

🌐 Docker

Caso necessite de instalar o Docker e/ou o Portainer a parte para ajudar a gerenciar seus containers, temos um post completo sobre o assunto aqui:

Como Instalar Docker e Portainer no Windows, Linux e MacOS

🚀 Passo a passo: Instalando o AppFlowy Cloud com autenticação GitHub

1. Clonar o repositório oficial

No seu servidor com Docker:

git clone https://github.com/AppFlowy-IO/AppFlowy-Cloud
cd AppFlowy-Cloud
Code language: PHP (php)

2. Configurar o arquivo `.env`

Copie o template:

cp deploy.env .env
nano .env
Code language: CSS (css)

Preencha com:

GOTRUE_JWT_SECRET: gere uma string aleatória.
SMTP (opcional): se quiser funcionalidades de e-mail.
GOTRUE_ADMIN: e-mail usado para login.
PGADMIN_DEFAULT_EMAIL e PGADMIN_DEFAULT_PASSWORD: para login no PgAdmin.
NGNIX_PORT e NGNIX_TLS_PORT: recomendo portas como 8048 e 8049 se já usa 80 e 443.
Habilite autenticação via GitHub:

GOTRUE_EXTERNAL_GITHUB_ENABLE=true
GOTRUE_EXTERNAL_GITHUB_CLIENT_ID=sua_client_id
GOTRUE_EXTERNAL_GITHUB_SECRET=sua_secret
GOTRUE_EXTERNAL_GITHUB_REDIRECT_URI=https://appflowy.seudominio.com.br/gotrue/callback
Code language: JavaScript (javascript)

3. Criar App OAuth no GitHub

Acesse: https://github.com/settings/developers
Clique em “New OAuth App”
Preencha com:
- App Name: AppFlowy
- Homepage URL: https://appflowy.seudominio.com.br/web/login
- Callback URL: https://appflowy.seudominio.com.br/gotrue/callback
Após criar, salve o Client ID e Client Secret e insira no .env.

Um ponto importante é que caso você deseje utilizar outro ou outros serviços de autenticação compatíveis, você pode, basta fazer o procedimento acima que é bem parecido nas demais plataformas como o Google, Discord, Apple e SAML 2.0, etc..

4. Iniciar os contêineres

No diretório do projeto:

docker compose up -d

Esse comando sobe todos os serviços: AppFlowy, banco, Redis, autenticação, Nginx, etc.

5. Acessar o AppFlowy

Acesse via navegador:

http://<IP_DO_SEU_SERVIDOR>
Code language: HTML, XML (xml)

Ou, se configurou DNS e TLS corretamente:

https://appflowy.seudominio.com.br

🔧 Considerações Adicionais

Portas: libere as portas utilizadas no firewall.
SSL: integre com Let’s Encrypt, Nginx Proxy Manager ou outro sistema.
Armazenamento S3: integre com MinIO ou serviço S3 para armazenar arquivos.
Autenticações extras: o AppFlowy suporta Google, Discord, Apple, SAML 2.0 — basta configurar no .env.