docs

Visão geral do self-host

Em breve

A versão para instalar no próprio servidor ainda não foi lançada, e hoje você pode usar o fazer.ai projects como SaaS em projects.fazer.ai. Esta seção descreve como a instalação vai funcionar.

O self-host é para você que quer rodar o fazer.ai projects no seu servidor e manter os dados da aplicação nele. Você prepara o ambiente, configura como o time entra e cuida das atualizações e dos backups.

As versões

  • Pro. Versão para instalar no seu servidor, destinada a membros da comunidade Lucas Moreira.
  • Free. Versão de código aberto para instalar no próprio servidor.

As duas versões ainda estão em planejamento e seguem sem data de lançamento.

O que você vai precisar

  • Um servidor Linux com Docker. Para um time, 2 vCPUs e 2 GB de memória dão conta. Com 2 GB, vale ativar swap.
  • PostgreSQL 18. O Docker Compose de exemplo já inclui uma instância do PostgreSQL.
  • Um domínio e um proxy reverso com HTTPS na frente da porta 3000. Você pode usar Traefik, Caddy ou nginx.
  • Pelo menos uma forma de entrar. Configure o login com Google via OAuth do Google Cloud ou um provedor de e-mail transacional, como Resend ou SMTP. Sem Google e sem e-mail, a aplicação sobe, mas ninguém consegue entrar.
  • Um bucket S3 privado, caso você queira usá-lo para guardar anexos. O bucket é opcional.

Como a instalação funciona

A aplicação roda em uma imagem Docker. Fixe sempre a imagem em uma tag de versão no formato vX.Y.Z. A tag latest deixa a versão em aberto. Toda vez que o contêiner inicia, ele aplica as migrações de banco de dados da versão em execução.

Quando o banco está vazio, a aplicação escreve no log um endereço de uso único no formato /setup?token=.... Abra esse endereço e entre com o Google. A conta que você usar vira administradora. Sem login com Google, rode bun set-admin <email> dentro do contêiner para criar a conta de administrador. Depois, use Esqueci a senha para definir a senha dessa conta. Esse fluxo precisa do e-mail transacional configurado.

Configuração

As opções de configuração ficam na página Docker Compose. Gere o JWT_SECRET, a ENCRYPTION_KEY e a senha do banco uma única vez e guarde esses valores. Se você trocar o JWT_SECRET, todo mundo sai da sessão. Se trocar a ENCRYPTION_KEY, os dados já cifrados ficam ilegíveis. Se usar uma senha nova com o volume antigo do banco, a aplicação perde o acesso aos dados.

Atualizar, backup e voltar versão

Para atualizar, troque a tag da imagem e suba o contêiner de novo. O novo contêiner aplica as migrações ao iniciar. Para voltar à versão anterior, volte a tag da imagem. As migrações que a versão mais nova aplicou continuam no banco. Por isso, faça um backup antes de toda atualização.

Use pg_dump diariamente para gerar um backup em formato custom e guarde o arquivo fora do servidor. Para conferir se o backup funciona, restaure o arquivo em um banco descartável. Use apenas esse banco para testar a restauração.

Próximos passos

On this page