{"id":35063324,"url":"https://github.com/kodustech/kodus-installer","last_synced_at":"2026-04-24T00:36:07.077Z","repository":{"id":283997848,"uuid":"952770753","full_name":"kodustech/kodus-installer","owner":"kodustech","description":"Install Kodus AI Agents in your own infra.","archived":false,"fork":false,"pushed_at":"2026-03-06T18:42:12.000Z","size":215,"stargazers_count":5,"open_issues_count":4,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-06T21:55:14.724Z","etag":null,"topics":["agents","ai-agents","ai-code-review","codereview","gen-ai","open-source","self-hosted"],"latest_commit_sha":null,"homepage":"https://kodus.io","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kodustech.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-21T21:14:37.000Z","updated_at":"2026-03-04T17:40:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"85fdf444-5127-4832-9846-2be478eb2440","html_url":"https://github.com/kodustech/kodus-installer","commit_stats":null,"previous_names":["kodustech/kodus-installer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kodustech/kodus-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodustech%2Fkodus-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodustech%2Fkodus-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodustech%2Fkodus-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodustech%2Fkodus-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kodustech","download_url":"https://codeload.github.com/kodustech/kodus-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kodustech%2Fkodus-installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32204710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T00:06:41.111Z","status":"ssl_error","status_checked_at":"2026-04-24T00:06:35.224Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai-agents","ai-code-review","codereview","gen-ai","open-source","self-hosted"],"created_at":"2025-12-27T10:59:11.335Z","updated_at":"2026-04-24T00:36:07.072Z","avatar_url":"https://github.com/kodustech.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://kodus.io/wp-content/uploads/2025/04/kodusinstaller.png\" alt=\"Kodus Installer Banner\"\u003e\n\n\u003c/div\u003e\n\n## Kodus Installer \n\nThis repository contains the configuration needed to deploy Kodus in your own infrastructure.\n\n## 🛠️ Prerequisites\n\n- Docker\n- Docker Compose\n- Git\n\n## 🔧 Installation\n\n`./scripts/install.sh`\n\nFor a full walkthrough on deploying, check out our docs: https://docs.kodus.io/how_to_deploy/en/deploy_kodus/generic_vm\n\nUpgrading from 1.x? See `MIGRATION.md`.\n\n### Guided install with Claude Code\n\nIf you use [Claude Code](https://claude.ai/claude-code), you can run an interactive installation that walks you through every configuration option, generates secrets automatically, and verifies the deployment at the end.\n\n```bash\nnpx skills add kodustech/kodus-installer@kodus-install\n```\n\nThen inside Claude Code, run:\n\n```\n/kodus-install\n```\n\n## External Databases or RabbitMQ\n\nIf you already have PostgreSQL/MongoDB or RabbitMQ, you can disable the local containers and point Kodus to the external services.\n\nExample `.env`:\n```bash\nUSE_LOCAL_DB=false\nUSE_LOCAL_RABBITMQ=false\n\nAPI_PG_DB_HOST=your-postgres-host\nAPI_PG_DB_PORT=5432\nAPI_MG_DB_HOST=your-mongodb-host\nAPI_MG_DB_PORT=27017\n\nAPI_RABBITMQ_URI=amqp://user:pass@your-rabbitmq-host:5672/kodus-ai\n```\n\nWhen set to `false`, the installer skips starting local services and related health checks.\n\n## Troubleshooting\n\nStart with the doctor script to pinpoint common setup issues: `./scripts/doctor.sh`\n\nCommon fixes:\n- Docker daemon not running: `docker info`\n- Ports already in use: `3000`, `3001`, `3101`, `3332`, `5432`, `9140`, `27017`, `5672`, `15672`, `15692`\n- `.env` missing or invalid: copy `.env.example` and fill required vars\n- RabbitMQ connection errors: ensure `API_RABBITMQ_URI` matches `RABBITMQ_DEFAULT_USER`, `RABBITMQ_DEFAULT_PASS`, and vhost `kodus-ai`\n- Database errors: confirm Postgres/Mongo credentials, then rerun `./scripts/setup-db.sh`\n- Service crash or boot loop: check logs with `docker compose logs -f api` (or `worker`, `webhooks`, `rabbitmq`)\n\n## Service Architecture\n\n```mermaid\nflowchart LR\n  user((User)) --\u003e web[kodus-web]\n  web --\u003e api[api]\n  web --\u003e webhooks[webhooks]\n  api --\u003e mcp[kodus-mcp-manager]\n  api --\u003e rabbitmq[(rabbitmq)]\n  worker[worker] --\u003e rabbitmq\n  api --\u003e pg[(db_kodus_postgres)]\n  api --\u003e mongo[(db_kodus_mongodb)]\n  mcp --\u003e pg\n  webhooks --\u003e pg\n  webhooks --\u003e mongo\n```\n\n## 📦 Available Services\n\n- **kodus-web**: Application frontend\n- **api**: Application API\n- **worker**: Background jobs\n- **webhooks**: Webhooks service\n- **kodus-mcp-manager**: MCP manager service\n- **rabbitmq**: Message broker\n- **db_kodus_postgres**: PostgreSQL database\n- **db_kodus_mongodb**: MongoDB database\n- **migration**: One-off migrations runner\n- **prometheus**: Monitoring system\n- **grafana**: Metrics visualization dashboard\n\n## 🔐 Security\n\n- All credentials are managed through environment variables\n- Secure inter-service communication\n- Container isolation\n- Dedicated Docker networks\n\n## 🤝 Contributing\n\nContributions are always welcome! Please read the contribution guidelines before submitting a pull request.\n\n1. Fork the project\n2. Create your Feature Branch (`git checkout -b feat/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feat/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\nFor support, email support@kodus.io or open an issue in the repository.\n\n---\n\n\u003cdiv align=\"center\"\u003e\nMade with ❤️ by the Kodus Team\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodustech%2Fkodus-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkodustech%2Fkodus-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkodustech%2Fkodus-installer/lists"}