Um projeto pessoal. Uma casa de possibilidades.
Tinha uma máquina velha sem uso aqui em casa. Hoje ela filtra anúncios, acompanha a internet, reúne a casa inteligente e roda um agente que conversa comigo sobre minhas faturas.
“Quero tirar meu homelab do papel.”
Ubuntu, serviços e integrações.
O resultado precisa funcionar de verdade.
Para manter e conseguir recuperar depois.
01 / Como começou
“Comecei a usar o Codex em casa e finalmente tirei meu projeto de homelab do papel.”Bruno · outubro de 2026
Instalei o Ubuntu Server no mini PC, coloquei o Codex e comecei a construir. A cada ideia, fui pedindo ajuda para configurar, entender as escolhas e conferir o resultado.
É isso que quero dizer quando falo que meu homelab foi vibecodado: construí com IA, conversando sobre o que queria e refinando conforme as coisas funcionavam. O projeto ganhou serviços, scripts, integrações e documentação.
O lab virou um lugar para meus projetos pessoais. Depois, passou a resolver coisas do dia a dia: a rede de casa, os dispositivos inteligentes e até a forma de acompanhar minhas compras.
02 / O que roda aqui
A base é Ubuntu Server, com Docker para os serviços em contêineres. Fui adicionando as peças conforme surgiam necessidades. Estas são as principais.
Coloquei um bloqueador de anúncios na rede. O AdGuard roda no servidor e o roteador distribui o DNS dele aos aparelhos. Assim, o filtro funciona nos dispositivos que usam esse DNS, sem depender de uma extensão em cada navegador.
O filtro impede consultas a domínios conhecidos de publicidade e rastreamento. Não é um bloqueio universal: anúncios servidos pelo mesmo domínio do conteúdo ou aparelhos que usam outro DNS podem escapar.
Instalei o Coolify para ter um painel de gerenciamento de aplicações. Ele permite partir de um projeto no GitHub, construir a aplicação e fazer o deploy em Docker no meu servidor.
O Docker organiza aplicações em contêineres. O Coolify cuida do processo de build, deploy e gerenciamento. O painel está instalado; a conexão com um repositório e cada publicação são etapas próprias que precisam de configuração e teste.
A cada hora, um teste mede download e upload e guarda os resultados em gráficos. Agora tenho um histórico da conexão ao longo do dia, em vez de depender de um teste isolado quando acho que a internet está lenta.
É a conexão por cabo do servidor. O resultado ajuda a acompanhar o link, mas não mede a cobertura do Wi-Fi em cada cômodo.
Também coloquei o Home Assistant para reunir a casa num painel: TVs, ar-condicionado, lava e seca, câmeras e alarme fazem parte desse projeto. A casa e o servidor passaram a ter um lugar em comum.
O dashboard Minha Casa reúne áreas como climatização, lavanderia, câmeras e HomeLab. Os seis canais de câmera ao vivo foram conferidos no navegador, e a aba HomeLab recebe as métricas do Beszel. Compatibilidade e controles dependem das integrações de cada equipamento.
Instalei um agente que se conecta ao WhatsApp e dei um nome para ele: Manoel. Posso mandar uma mensagem e pedir que ele consulte os projetos e as ferramentas que conectei.
O OpenClaw roda no servidor e organiza o agente, as conversas e as ferramentas. O modelo de IA usa um serviço externo. Ter o agente em casa não significa que a inferência do modelo acontece no mini PC.
O Homepage reúne os atalhos. O Uptime Kuma acompanha a disponibilidade dos serviços. O Beszel mostra CPU, memória, disco e o consumo dos contêineres. Cada um responde a uma pergunta diferente sobre o servidor.
Um monitor HTTP confirma que uma página responde, mas não testa todos os recursos de uma aplicação. Também mantive alertas de operação separados, para avisar sobre problemas nos serviços, disco e backups.
03 / Como tudo se conecta
Escolha um caminho para entender o papel de cada peça.
Mapa conceitual da integração. Os painéis administrativos continuam na rede privada.
FINANCE / DOS DADOS À CONVERSA
A Pluggy disponibiliza os dados das conexões; o Finance organiza a cópia local. O Manoel consulta essa base por ferramentas MCP e responde na conversa. A importação faz a ligação entre as duas linhas do mapa.
04 / O caso de uso que mudou a rotina
Criei uma conta na Pluggy para importar dados dos meus cartões e transações. O projeto Finance organiza essa informação e dá ao Manoel uma fonte concreta para consultar.
Posso perguntar sobre compras, faturas e cobranças que parecem se repetir. A resposta precisa considerar a última atualização, as parcelas, os estornos e os pagamentos disponíveis.
Perguntar “quanto está em aberto?” exige cobertura dos pagamentos. A falta de um pagamento importado, sozinha, não comprova dívida.
Explore exemplos de perguntas:
Estes exemplos explicam o funcionamento. Não consultam contas reais nem enviam mensagens.
Configurei uma automação para analisar os movimentos do dia anterior e enviar um resumo no meu WhatsApp. Ela destaca compras, mantém os Pix recebidos separados e pode sinalizar algo que merece conferência.
A rotina também verifica faturas com vencimento formal para hoje ou daqui a três dias, quando elas estão disponíveis. Cobranças semelhantes são pistas para conferir, não prova de fraude ou de uma assinatura.
05 / O que sustenta o projeto
O que mantém o lab útil é conseguir acompanhar, entender e recuperar o que roda nele. Esses cuidados fizeram parte da construção.
SSH por chave, firewall, HTTPS e Tailscale para os acessos remotos configurados. Apresentar o projeto aqui não abre seus painéis para a internet.
Cópias criptografadas no Google Drive, conferência de integridade e testes de restauração isolada já realizados. Recuperação completa em outra máquina é uma etapa adicional.
Decisões, configurações, scripts e resultados registrados no repositório. Credenciais ficam fora do Git. Isso ajuda a retomar o projeto sem depender da memória de uma conversa.
Usei o Codex para transformar pedidos em configurações, scripts e ajustes. Eu defini o que queria, acompanhei as decisões e conferi resultados. O projeto combina ferramentas existentes; o trabalho foi montar e integrar as peças para a minha rotina.
Os serviços do lab e a base local do Finance ficam no servidor. Algumas partes dependem de serviços externos: o modelo de IA, a Pluggy, o WhatsApp e o destino dos backups. É uma arquitetura com componentes locais e externos.
Esta integração foi feita para consultar e analisar os dados importados. As ferramentas de edição configuradas atuam na cópia local do Finance; não realizam operações bancárias. O resumo diário usa somente leitura.
Ele já tem usos concretos, mas continua evoluindo. Ainda existem tarefas de recuperação, cobertura de backups e validações de acesso. A disponibilidade das próximas faturas também depende dos dados que chegam pelas conexões financeiras.
Porque era a máquina que eu já tinha. Ela deu um ponto de partida para experimentar, aprender sobre operação e hospedar os serviços pessoais. O dimensionamento depende do que cada pessoa pretende rodar; não fiz um teste de carga para recomendar este hardware para qualquer cenário.
O lab continua
Começou com Ubuntu e Codex. Cresceu para cuidar da rede, receber meus projetos e conectar a casa. E ganhou um nome no WhatsApp: Manoel.
Voltar ao começo