Guia de Solução de Problemas

​

Soluções Rápidas

​

”Executar diagnósticos”

cd kodus-installer
./scripts/doctor.sh

​

”Não consigo acessar a interface web”

1. Verifique se os contêineres estão em execução:

docker-compose ps kodus-web

2. Verifique se as portas estão mapeadas corretamente:

docker-compose port kodus-web 3000

3. Verifique os logs do contêiner web:

docker-compose logs kodus-web

​

“Erros de Edge Runtime nos logs do kodus-web”

1. Atualize para a imagem mais recente do kodus-web (re-execute o instalador ou rode docker-compose pull kodus-web e docker-compose up -d).
2. Se estiver compilando a partir do código-fonte, certifique-se de que as rotas de auth/server sejam executadas no runtime do Node.js (defina export const runtime = "nodejs" e evite runtime = "edge" nessas rotas).
3. Reconstrua e reinicie o contêiner.

​

”Os webhooks Git não estão funcionando”

1. Verifique a configuração do seu domínio:

curl -I https://your-domain.com

2. Verifique os logs de webhooks para tentativas de webhook:

docker-compose logs webhooks | grep webhook

3. Verifique a configuração do seu proxy reverso:

sudo nginx -t

​

“Problemas de conexão com o banco de dados”

1. Verifique o status dos contêineres do banco de dados:

docker-compose ps db_kodus_postgres
docker-compose ps db_kodus_mongodb

2. Verifique os logs do banco de dados:

docker-compose logs db_kodus_postgres
docker-compose logs db_kodus_mongodb

3. Teste as conexões com o banco de dados:

docker-compose exec db_kodus_postgres psql -U $API_PG_DB_USERNAME -d $API_PG_DB_DATABASE
docker-compose exec db_kodus_mongodb mongosh -u $API_MG_DB_USERNAME -p $API_MG_DB_PASSWORD

​

“Migração falhou por tipo vector ausente”

1. Conecte-se ao seu banco de dados PostgreSQL:

docker-compose exec db_kodus_postgres psql -U $API_PG_DB_USERNAME -d $API_PG_DB_DATABASE

2. Habilite a extensão pgvector:

CREATE EXTENSION IF NOT EXISTS vector;

3. Após habilitar a extensão, tente executar suas migrações novamente:

docker-compose exec api npm run migration:run

SELECT * FROM pg_extension WHERE extname = 'vector';

​

Problemas Comuns

​

Problemas com RabbitMQ

1. Verifique o status do RabbitMQ:

docker-compose logs rabbitmq

2. Acesse o console de gerenciamento em http://localhost:15672 para verificar filas e conexões
3. Reinicie o serviço se necessário:

docker-compose restart rabbitmq

​

Problemas de Recursos

1. Verifique o uso de recursos:

docker stats

2. Verifique os limites dos contêineres:

docker inspect $(docker-compose ps -q api) | grep -A 5 "Resources"

3. Ajuste os limites de recursos no docker-compose.yml se necessário

​

Obtendo Ajuda

​

O que Incluir em Solicitações de Suporte

• A mensagem de erro exata
• Logs relevantes dos serviços afetados
• Seu método de implantação (CLI, VM, etc.)
• Passos para reproduzir o problema

​

Onde Obter Ajuda

• Comunidade Discord
• Issues no GitHub