Se requiere acceso a internet si planeas conectarte a servicios Git en la nube (GitHub, GitLab, Bitbucket) o proveedores de LLM en la nube (OpenAI, Anthropic, etc.). Para herramientas Git auto-alojadas y LLMs on-premise dentro de tu red, el acceso externo a internet es opcional.
Si planeas integrar Kodus con proveedores Git en la nube (GitHub, GitLab o Bitbucket), necesitarás URLs públicas tanto para la aplicación web de Kodus como para su API. Esto permite que tu servidor reciba webhooks para el correcto funcionamiento de la Revisión de Código y garantiza el comportamiento correcto de la aplicación.Recomendamos configurar dos subdominios:
Uno para la Aplicación Web, por ejemplo, kodus-web.tudominio.com.
Uno para la API, por ejemplo, kodus-api.tudominio.com.
Los webhooks son gestionados por un servicio separado (puerto 3332). Puedes:
Usar un subdominio dedicado para webhooks, por ejemplo, kodus-webhooks.tudominio.com, o
Seguir usando el dominio de la API y enrutar /github/webhook, /gitlab/webhook, etc. al servicio de webhooks en tu proxy inverso.
Ambos subdominios deben tener registros DNS A apuntando a la dirección IP de tu servidor. Más adelante en esta guía, configuraremos un proxy inverso (Nginx) para enrutar las solicitudes de estos subdominios a los servicios internos correctos. Esta configuración es esencial para la funcionalidad completa, incluyendo webhooks y autenticación.
Nota: Si solo te conectas a herramientas Git auto-alojadas en tu red y no necesitas acceso público ni webhooks, podrías usar una configuración más simple, pero esta guía se centra en despliegues con acceso público.
Usa esta sección para completar tu .env. Comienza con las URLs públicas, luego
configura las bases de datos y RabbitMQ, y finalmente agrega la configuración
específica de cada proveedor.
Estas configuraciones definen las URLs públicas y el enlace de host utilizados por la aplicación web y la API.
Si no usas MCP Manager, puedes omitir las entradas de MCP aquí y el
bloque completo a continuación.
WEB_HOSTNAME_API="kodus-api.yourdomain.com" # Hostname público de la API (ej., kodus-api.yourdomain.com)NEXTAUTH_URL="https://kodus-web.yourdomain.com" # URL base pública completa para la aplicación web (ej., https://kodus-web.yourdomain.com)API_HOST=0.0.0.0 # Host de la API (0.0.0.0 para desarrollo local)# Solo necesario si quieres usar las funcionalidades de MCP.API_KODUS_SERVICE_MCP_MANAGER=http://kodus-mcp-manager:3101 # URL del MCP ManagerAPI_KODUS_MCP_SERVER_URL=http://kodus-api.yourdomain.com/mcp # URL del servidor MCP de Kodus
API_LLM_PROVIDER_MODEL="gpt-5" # Modelo que deseas utilizarAPI_OPENAI_FORCE_BASE_URL="https://your-api.com/v1" # URL de tu proveedor de APIAPI_OPEN_AI_API_KEY="your-api-key" # Clave de tu proveedor de API
Consulta nuestras guías específicas por modelo para obtener instrucciones detalladas de configuración con proveedores populares como Novita, OpenAI, Anthropic y más.
Usa contenedores locales para Postgres y MongoDB de forma predeterminada. Actualiza las credenciales
para que cumplan con tus requisitos de seguridad.
# Usar contenedores locales para Postgres y MongoDBUSE_LOCAL_DB=true# Configuración de PostgreSQLAPI_DATABASE_ENV="development" # development, production, testAPI_PG_DB_HOST=db_kodus_postgres # Host de PostgreSQLAPI_PG_DB_PORT=5432 # Puerto de PostgreSQLAPI_PG_DB_USERNAME=kodusdev # Nombre de usuario de la base de datosAPI_PG_DB_PASSWORD= # Contraseña de la base de datosAPI_PG_DB_DATABASE=kodus_db # Nombre de la base de datos# Configuración de MongoDBAPI_MG_DB_HOST=db_kodus_mongodb # Host de MongoDBAPI_MG_DB_PORT=27017 # Puerto de MongoDBAPI_MG_DB_USERNAME=kodusdev # Nombre de usuario de la base de datosAPI_MG_DB_PASSWORD= # Contraseña de la base de datosAPI_MG_DB_DATABASE=kodus # Nombre de la base de datosAPI_MG_DB_PRODUCTION_CONFIG='' # Configuración adicional de producción
RabbitMQ es obligatorio en la versión 2.0. Mantén la URI sincronizada con los valores a continuación.
# Configuración de RabbitMQUSE_LOCAL_RABBITMQ=trueRABBITMQ_HOSTNAME=rabbitmq # Hostname de RabbitMQ en la red DockerRABBITMQ_DEFAULT_USER=kodus # Usuario de RabbitMQ (cambiar en producción)RABBITMQ_DEFAULT_PASS=kodus # Contraseña de RabbitMQ (cambiar en producción)# Mantén la URI sincronizada con el usuario, contraseña y vhost de arribaAPI_RABBITMQ_URI=amqp://kodus:kodus@rabbitmq:5672/kodus-ai # URI de conexión a RabbitMQAPI_RABBITMQ_ENABLED=true # RabbitMQ es obligatorio
Elige y configura tu proveedor Git preferido. Puedes configurar uno o más
proveedores; para la autenticación básica basada en token, solo necesitas la URL del webhook.
Los webhooks son gestionados por un servicio separado (puerto 3332). Las URLs de tus webhooks deben llegar a ese servicio. Puedes usar un dominio dedicado para webhooks, o mantener el dominio de la API y enrutar las rutas /.../webhook al servicio de webhooks en tu proxy inverso.
¿Usas OAuth de GitHub o GitLab? Consulta OAuth App de GitHub o OAuth App de GitLab. Para la configuración de GitHub App, consulta GitHub App.
Github
GitLab
Bitbucket
Azure DevOps
# Requerido para autenticación basada en tokenAPI_GITHUB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/github/webhook" # URL del webhook (usa el dominio de webhooks, o el dominio de la API si se enruta al servicio de webhooks)
# Requerido para autenticación basada en tokenAPI_GITLAB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/gitlab/webhook" # URL del webhook (usa el dominio de webhooks, o el dominio de la API si se enruta al servicio de webhooks)
# Requerido para autenticación basada en tokenGLOBAL_BITBUCKET_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/bitbucket/webhook" # URL del webhook (usa el dominio de webhooks, o el dominio de la API si se enruta al servicio de webhooks)
# Requerido para autenticación basada en tokenGLOBAL_AZURE_REPOS_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/azure-repos/webhook" # URL del webhook (usa el dominio de webhooks, o el dominio de la API si se enruta al servicio de webhooks)
MCP Manager es el servicio que conecta Kody con herramientas externas y las expone
en la pantalla de Plugins. Consulta nuestra documentación de MCP Manager
para más información.
API_MCP_SERVER_ENABLED=false # Cambiar a true si deseas usar MCP Manager---API_KODUS_SERVICE_MCP_MANAGER=http://kodus-mcp-manager:3101API_KODUS_MCP_SERVER_URL=http://localhost:3001/mcp# Configuración de MCP ManagerAPI_MCP_MANAGER_LOG_LEVEL=infoAPI_MCP_MANAGER_PORT=3101API_MCP_MANAGER_NODE_ENV=developmentAPI_MCP_MANAGER_DATABASE_ENV=developmentAPI_MCP_MANAGER_CORS_ORIGINS=*API_MCP_MANAGER_JWT_SECRET=API_MCP_MANAGER_COMPOSIO_BASE_URL=https://backend.composio.dev/api/v3API_MCP_MANAGER_COMPOSIO_API_KEY=API_MCP_MANAGER_MCP_PROVIDERS=kodusmcp,composio,customAPI_MCP_MANAGER_REDIRECT_URI=http://localhost:3000/setup/mcp/oauthAPI_MCP_MANAGER_PG_DB_SCHEMA=mcp-managerAPI_MCP_MANAGER_ENCRYPTION_SECRET=
Solo necesario si deseas habilitar la revisión de código basada en AST.
El servicio AST analiza, recorta y manipula archivos de código antes de que lleguen al pipeline de revisión. Esto mejora la calidad de la revisión y reduce el consumo de tokens. Está incluido en el instalador y se ejecuta como un contenedor separado.
API_ENABLE_CODE_REVIEW_AST=false # Establecer en true para habilitar la revisión de código basada en ASTAPI_SERVICE_AST_URL= # URL interna del servicio AST
El servicio AST también tiene su propio bloque de configuración. Estos valores están preconfigurados por el instalador, pero se pueden ajustar para que coincidan con tu entorno:
# KODUS_SERVICE_ASTNODE_ENV=developmentAPI_NODE_ENV=developmentAPI_LOG_PRETTY=trueAPI_LOG_LEVEL=infoCONTAINER_NAME=kodus-service-astAPI_PORT=3002# PostgreSQL — mantener sincronizado con la configuración principal de la base de datosAPI_DATABASE_ENV="development"API_PG_DB_HOST=postgresAPI_PG_DB_PORT=5432API_PG_DB_USERNAME= # Igual que API_PG_DB_USERNAMEAPI_PG_DB_PASSWORD= # Igual que API_PG_DB_PASSWORDAPI_PG_DB_DATABASE=kodus_dbAPI_PG_DB_SCHEMA=kodus_workflow# RabbitMQ — mantener sincronizado con la configuración principal de RabbitMQRABBIT_URL= # ej. amqp://user:pass@rabbitmq:5672/vhostRABBIT_RETRY_QUEUE=ast.jobs.retry.qRABBIT_RETRY_TTL_MS=60000RABBIT_PREFETCH=1RABBIT_PUBLISH_TIMEOUT_MS=5000RABBIT_SAC=false# LangChain (opcional — para trazado)LANGCHAIN_TRACING_V2=falseLANGCHAIN_API_KEY=LANGCHAIN_PROJECT=kodus-service-ast# Almacenamiento compartidoSHARED_STORAGE_PATH=/shared# S3 (opcional)S3_ENABLED=falseS3_BUCKET_NAME=AWS_REGION=# Opciones de construcción de grafosENABLE_INCREMENTAL_GRAPH=falseENABLE_GRAPH_BENCHMARK=falseENABLE_LIGHTWEIGHT_GRAPH=false
Estos servicios son opcionales pero mejoran significativamente la calidad de la revisión de código de Kodus. Cada uno requiere crear una cuenta y generar una clave de API.
E2B — Sandbox de ejecución de código
E2B proporciona un sandbox seguro que Kodus usa para ejecutar y validar código durante las revisiones.
MorphLLM es un modelo especializado para la edición de código rápida y precisa. Kodus lo utiliza para aplicar sugerencias de revisión con mayor precisión.
