Skip to main content
Docker Compose runs all Greptile services on a single Linux host. Recommended for teams up to 100 developers.

​
Choose Your Setup Path

AWS with Terraform

Automated infrastructure + app deployment. Single terraform apply creates VPC, EC2, RDS, Redis, and bootstraps Greptile.

Manual Setup

Bring your own Linux server. Works on any cloud (GCP, Azure) or on-prem.

​
Prerequisites

​
Server Requirements

OS: Ubuntu 20.04+, Amazon Linux 2023, or equivalent Software: Docker 23.x+, Docker Compose v2.5+

​
External Dependencies

Container Registry — Credentials provided by Greptile for pulling images. LLM Provider — At least one of:
  • Anthropic (Claude)
  • OpenAI
  • Azure OpenAI
  • AWS Bedrock
SCM Platform — GitHub App or GitLab OAuth configured.

​
Architecture

Greptile architecture

​
Services

Background workers (greptile-indexer-chunker, greptile-indexer-summarizer, greptile-jobs) run without exposed ports.

​
Network Requirements

Inbound:
  • 3007 — SCM webhooks (required, must be publicly accessible)
  • 3000 — Web UI
  • 8080 — Hatchet admin (optional)
Outbound:
  • LLM provider APIs
  • SCM provider APIs
  • Container registry

​
Next Steps