System Requirements
The gateway ships as a single container image (python:3.12-slim base) that runs as a non-root user. It is light — most of the sizing decision is about how much cache you want to hold locally.
| Requirement | Specification |
|---|---|
| Runtime | Docker Engine 20.10+ or Kubernetes v1.24+ (Helm v3 for the chart) |
| Image | python:3.12-slim base, runs as non-root (UID 1000) |
| Memory | 256 MB request, 1–2 GB typical under fleet load |
| Cache storage | S3 bucket (recommended — stateless pods) or local disk (CACHE_MAX_SIZE_GB, default 50) |
| Listening port | 80 (HTTP). TLS terminated at an Ingress/LB, or in-pod via TLS_CERT_FILE |
| Outbound access | api.roboflow.com, repo.roboflow.com, storage.googleapis.com, and *.roboflow.cloud for dedicated deployments |
Sizing note. With an S3 cache the local disk footprint is negligible and pods stay stateless. With a disk cache, plan for your hot set plus headroom — the default cap is 50 GB (CACHE_MAX_SIZE_GB) and the gateway always keeps CACHE_FREE_DISK_BUFFER_GB free. Container images and model weights are the largest items.