Skip to main content

​
Quick Decision

Use Cloud if you want Greptile running in minutes with zero infrastructure management. Use Self-Hosted if you need data sovereignty, air-gapped environments, or custom LLM providers. For self-hosted, choose based on team size:
  • Docker Compose: Up to 100 developers. Single VM, simpler operations.
  • Kubernetes: 100+ developers. Horizontal scaling, high availability.

​
Self-Hosted: Docker Compose

Runs all services on a single Linux VM using Docker Compose.

​
Two Setup Paths

AWS with Terraform — If you’re on AWS and want automated provisioning:
  • Terraform creates VPC, EC2, RDS PostgreSQL, ElastiCache Redis
  • Bootstraps the EC2 with Docker Compose and starts Greptile
  • Single terraform apply gets you running
  • Go to AWS Terraform guide →
Manual Setup — If you’re on GCP, Azure, on-prem, or want control over infrastructure:
  • You provision a Linux VM and any external databases
  • Clone the repo, configure .env, run Docker Compose
  • Works anywhere Docker runs
  • Go to Manual Setup guide →

​
Requirements

VM Sizing:
Team SizeCPURAMStorage
5-10 devs4 cores16GB100GB
~50 devs8 cores32GB200GB
100 devs32 cores128GB500GB
Software: Linux (Ubuntu 20.04+, Amazon Linux 2023), Docker 23.x+, Docker Compose v2.5+ Network: Inbound access on port 3007 for SCM webhooks. Outbound HTTPS to LLM and SCM providers.

​
Self-Hosted: Kubernetes

Runs services across a Kubernetes cluster using Helm charts. Provides horizontal scaling, rolling updates, and high availability.

​
Requirements

Cluster: Kubernetes 1.21+ (1.25+ recommended), Helm 3.0+ External Services: PostgreSQL with pgvector (RDS recommended), Redis (ElastiCache recommended) Sizing:
Team SizeNodesPer NodeTotal
50 devs3-58c / 32GB24-40 cores
100-500 devs5-1016c / 64GB80-160 cores
500+ devs10-20+16-32c / 64-128GB160-640+ cores
Go to Kubernetes guide →

​
External Dependencies

All self-hosted deployments require:

​
LLM Providers

You need three model types configured:
Model TypeUsed ForOptions
Smart (reasoning)Code review, agent tasksClaude 3.5 Sonnet+, GPT-4o
FastSummarization, quick tasksGPT-4o-mini, Claude Haiku
EmbeddingsCode indexingtext-embedding-3-small, Titan V2
Supported providers: OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, GCP Vertex AI.

​
Source Code Management

PlatformSetup Required
GitHub / GitHub EnterpriseGitHub App with webhook URL
GitLabOAuth app configuration
PerforceP4USER, P4PASSWD, P4PORT, P4CLIENT env vars

​
Container Registry

Access to Greptile’s Docker images. Contact Greptile for registry credentials.

​
Migration

Docker Compose to Kubernetes migration is supported via parallel deployments. Run both simultaneously, then switch traffic at the load balancer or DNS level.

​
Pricing

Self-hosted requires a license. Contact [email protected].