This repository provides deployment artifacts and documentation for self-hosted Greptile. It is intended for operators and IT administrators who install and maintain Greptile in their own environment.
Greptile runs as independently scalable services. The stack depends on Hatchet for task orchestration and PostgreSQL for persistence. See Architecture overview for the service list. The following diagram shows the current self-hosted architecture:
We offer two methods of deployment - docker-compose and kubernetes.
- Method via docker-compose: Easy single node setup, suited for smaller teams. See Install with Docker Compose.
- Method via kubernetes: Enterprise ready setup. See Install with Kubernetes.
- Installation: Requirements · Install with Docker Compose · Install with Kubernetes
- Configuration: Networking · GitHub App creation · LLM providers · Single sign-on (SSO)
- Operations: Upgrade · Scaling · Troubleshooting · Observability
- Reference: Architecture overview