Deployment¶
Grafeo-server can be deployed anywhere Docker runs. This section covers cloud-specific guides for running a production Grafeo instance on managed serverless infrastructure.
Deployment Options¶
| Option | Best For | Scale-to-Zero | Setup Effort |
|---|---|---|---|
| Docker | Self-hosted, on-premise, VMs | No | Low |
| Azure | Azure Container Apps | Yes | Medium |
| AWS | App Runner or Fargate | Partial | Medium |
| GCP | Cloud Run | Yes | Medium |
| Kubernetes | ASK, EKS, GKE, self-managed | No (pod-level) | Higher |
Choosing a Tier¶
All deployment guides use the same Docker images. Pick the tier that matches your workload:
| Tier | Tag | Transport | Use Case |
|---|---|---|---|
| gwp | grafeo-server:gwp |
gRPC :7688 | Sidecar, CI/CD, edge |
| bolt | grafeo-server:bolt |
Bolt :7687 | Neo4j driver compatibility |
| standard | grafeo-server:latest |
HTTP :7474 | General purpose, Studio UI |
| full | grafeo-server:full |
All protocols | Production with auth, TLS, AI/search |
See grafeo-server for detailed tier comparison, environment variables, and API reference.
Common Configuration¶
All deployments support the same environment variables:
| Variable | Default | Description |
|---|---|---|
GRAFEO_DATA_DIR |
(none) | Persistence path (omit for in-memory) |
GRAFEO_QUERY_TIMEOUT |
30 |
Query timeout in seconds |
GRAFEO_SESSION_TTL |
300 |
Transaction session timeout in seconds |
GRAFEO_LOG_FORMAT |
pretty |
pretty or json (use json for cloud logging) |
GRAFEO_AUTH_TOKEN |
(none) | Bearer token (full tier only) |
Full configuration reference: Configuration