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

Team SizeCPURAMStorage
5-10 devs4 cores16GB100GB
~50 devs8 cores32GB200GB
100 devs32 cores128GB500GB
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

ServicePortPurpose
greptile-web3000Web UI
greptile-api3001REST API
greptile-auth3002Authentication
greptile-webhook3007SCM webhooks
greptile-reviews3005PR review generation
greptile-llmproxy4000LLM request routing
hatchet-*8080Workflow orchestration
greptile-postgres5432Application database
saml-jackson5225SAML SSO (optional)
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