Um VPS com Coolify e Outline oferece um painel para implantar serviços e uma base de documentação para seu futuro funcionário de IA. Você precisa de acesso ao servidor e de um domínio para acompanhar a configuração do vídeo com seus próprios subdomínios. Esta primeira parte deixa a infraestrutura e a documentação funcionando; a memória com RAG, o MCP e as automações serão conectados depois.
Na minha configuração, uso um VPS da Hostinger, que patrocinou o vídeo, e seleciono o Coolify pelo painel dela. O objetivo é hospedar vários serviços no mesmo servidor e reduzir as assinaturas que pago separadamente. O servidor continua tendo um custo, e a administração fica por sua conta.
O que você vai montar e de quais recursos precisa
A estrutura começa pelo VPS, onde os serviços são executados. Sobre ele fica o Coolify, o painel pelo qual você faz a implantação e a configuração desses serviços. O Outline será o espaço para guardar documentação, decisões e notas por projeto.
O Coolify gerencia a implantação, enquanto o Outline oferece o editor e a organização dos documentos. O Outline permite hospedar tudo na sua própria infraestrutura e oferece recursos de colaboração e permissões. (getoutline.com)
Para reproduzir o passo a passo do vídeo, você precisa de:
- Um VPS com acesso ao painel do provedor.
- Coolify instalado ou disponível como opção de instalação.
- Um domínio cujo DNS você possa editar.
- O endereço IP público do servidor.
No vídeo, recomendo o KVM 2 como ponto de partida e o KVM 4 se você for montar todos os serviços da série. Essa recomendação também considera os componentes que vêm depois: com 4 GB de RAM, o conjunto que quero implantar fica no limite.
Se quiser entender primeiro o papel do painel, confira o artigo sobre Coolify como alternativa à Vercel. Aqui, o foco é deixar pronta a documentação que os agentes vão usar.
Como preparar o Coolify no VPS
-
Selecione o Coolify ao configurar o servidor.
No passo a passo da Hostinger, o painel aparece entre as opções de instalação. Depois, você escolhe a localização do VPS e configura as credenciais de acesso. Recomendo usar uma chave SSH, embora na demonstração eu use uma senha.
Se você já tem um servidor com serviços ou dados, confira as consequências antes de aplicar outra imagem ou outro sistema pelo provedor. Reserve este passo a passo para um VPS novo ou preparado para essa instalação.
-
Abra o painel do Coolify e crie sua conta.
Quando a instalação termina, o provedor exibe o acesso ao painel. No vídeo, ele é aberto pelo IP do servidor e pela porta
8000. Crie a conta de administrador antes de continuar com os recursos.Conclua o assistente inicial e selecione a própria máquina como servidor de implantação. Depois, crie o primeiro projeto, que servirá para agrupar o Outline e seus recursos.
Ao final desta etapa, você deve ter um painel acessível e um projeto disponível. Ainda não precisa implantar bancos de dados ou aplicações separadamente: o próximo recurso será criado a partir de um modelo.
Como configurar um domínio para o painel
- Crie um registro A para o subdomínio do Coolify.
Fonte: Configurações da instância
Acesse o gerenciador de DNS do seu domínio e adicione um registro do tipo A. Use coolify como nome e o IP público do VPS como destino. Esse registro direciona o subdomínio para o servidor onde está o painel. (coolify.io)
No vídeo, faço essa alteração pela Hostinger. Se você gerencia o DNS em outro provedor, crie o registro nesse provedor.
-
Salve o endereço completo nas configurações do Coolify.
Abra “Settings”, procure o campo “URL” e insira seu subdomínio com o prefixo
https://. Salve as alterações depois de apontar o DNS para o servidor. O Coolify usa esse endereço para o acesso ao painel e para gerar links da instância. (coolify.io)Confira se você consegue abrir o painel pelo domínio e fazer login. Use um subdomínio exclusivo para o Coolify: compartilhar o mesmo endereço com uma aplicação pode causar conflitos de roteamento e certificados. (coolify.io)
No meu teste, o domínio começou a responder antes de todo o acesso HTTPS ficar como eu esperava. DNS e HTTPS são verificações diferentes: confirme que o nome aponta para o servidor e que o navegador aceita o certificado antes de considerar esta etapa concluída. (coolify.io)
Como implantar o Outline a partir de um modelo
-
Adicione o Outline ao projeto.
Acesse “Projects”, abra o projeto criado e clique em “New resource”. Procure “Outline” na lista de serviços e selecione o modelo. No vídeo, dou a ele o nome “Outline documentação” para identificá-lo no painel.
Revise os dados gerados pelo modelo e salve a configuração. As credenciais do PostgreSQL que aparecem fazem parte da implantação; evite copiá-las em capturas de tela ou documentos compartilhados.
-
Atribua um subdomínio à documentação.
No campo de domínio do serviço, configure o subdomínio que quiser usar. Eu uso
docu. Depois, crie outro registroA, com esse nome e o mesmo IP público do VPS.Quando o Coolify solicitar a porta do serviço, selecione
3000, como na demonstração. Essa porta identifica o destino dentro do contêiner para o qual o proxy deve enviar as requisições. (coolify.io) -
Faça a implantação do recurso.
Abra “Actions” e clique em “Deploy”. No vídeo, o Coolify baixa as imagens e inicia os contêineres. Aguarde o processo terminar e confira o estado dos componentes antes de abrir o Outline.
Na minha instalação, o serviço ficou com o status “Running” e a verificação do domínio mostrou “DNS match”. O DNS demorou mais que a inicialização dos contêineres, então fui verificando as duas coisas separadamente.
Para consultar os requisitos da própria aplicação, confira a documentação oficial de hospedagem do Outline. A instalação precisa de serviços de apoio, entre eles PostgreSQL e Redis; por isso, você deve revisar o conjunto da implantação quando algo falhar. (docs.getoutline.com)
Como configurar o acesso à documentação
-
Abra o Outline pelo link do recurso.
Use “Links” no Coolify para acessar pelo domínio configurado. Na implantação do vídeo, o primeiro acesso pede o nome do espaço de trabalho, o administrador e seu e-mail. Conclua esse cadastro e confira se você consegue acessar o editor.
Crie uma coleção para um projeto e salve um documento. O Outline organiza a documentação em coleções e oferece permissões para controlar quem pode acessar o conteúdo. (getoutline.com)
-
Configure um método de acesso que você possa usar novamente.
Atenção: resolva a autenticação antes de encerrar a sessão inicial. Na minha implantação, configuro uma passkey nas configurações e explico a alternativa de acesso por e-mail.
Para acessar por e-mail, preencha a configuração SMTP nas variáveis de ambiente do serviço e aplique as alterações. No vídeo, a opção de e-mail não estava disponível até esses dados serem configurados.
Se você for usar esse método, confira o tutorial de SMTP com Oracle Cloud. Ele ajuda a preparar o envio de e-mails necessário para o login.
A verificação que vale é sair do Outline e entrar novamente com o método configurado. Manter uma aba aberta só confirma que a sessão atual continua ativa.
Erros que apareceram durante a implantação
O primeiro obstáculo foi a validação do domínio. Eu tinha criado o registro, mas o Coolify ainda não o detectava. Confira o nome do subdomínio e o IP de destino; depois, repita a verificação quando a alteração no DNS já estiver respondendo. (coolify.io)
O segundo foi o status “Degraded” do contêiner do Outline. No meu teste, a imagem com a tag latest dava problemas, e resolvi isso editando o Docker Compose para fixar uma versão que já estava funcionando em outra instalação. Guarde uma referência da versão que funciona para você antes de atualizá-la.
Se acontecer algo parecido com você, abra os logs do componente afetado antes de trocar as imagens. Confira se a falha está no Outline ou em algum dos serviços de apoio, porque a aplicação precisa que essas dependências estejam disponíveis. (docs.getoutline.com)
O terceiro ponto foi o acesso por e-mail desativado. Na implantação mostrada, a solução foi preencher os dados SMTP nas variáveis de ambiente. Salve essas credenciais como segredos do serviço e evite incluí-las na documentação que você vai consultar depois com agentes.
Como conferir se a base está pronta
-
Verifique o fluxo completo pelo navegador.
Acesse o Coolify pelo domínio e abra o recurso do Outline. Acesse a documentação, crie uma coleção, salve uma nota e abra-a novamente. Depois, saia da conta e confira se consegue se autenticar de novo.
Esse teste confirma a implantação e o acesso aos documentos. A conexão dessa documentação com o RAG e o MCP fica para a próxima parte da configuração.
Crie agora uma coleção para um projeto real e salve o objetivo dele, as decisões tomadas e as tarefas pendentes. Essa será a primeira documentação útil que você vai conectar à memória do seu funcionário de IA.
O que você achou?
Deixe sua opinião, pergunta ou sugestão. Os comentários são sincronizados com GitHub Discussions .