Implementation:Risingwavelabs Risingwave Docker Compose Deployment
| Knowledge Sources | |
|---|---|
| Domains | Deployment, Infrastructure, Docker |
| Last Updated | 2026-02-09 07:00 GMT |
Overview
Concrete tool for deploying a complete RisingWave cluster with infrastructure dependencies provided by Docker Compose configuration files.
Description
The Docker Compose Deployment consists of a set of docker-compose.yml files that define the complete RisingWave cluster topology and its infrastructure dependencies. The default standalone configuration packages all RisingWave components (meta, compute, frontend, compactor) into a single container with PostgreSQL for metadata, MinIO for object storage, Prometheus for metrics, Grafana for dashboards, and Redpanda for message queuing.
Usage
Use this when deploying RisingWave locally for development, testing, or evaluation. Select the appropriate compose file based on your storage backend needs.
Code Reference
Source Location
- Repository: risingwave
- File: docker/docker-compose.yml
- Lines: L1-254
Signature
# Standalone deployment (default)
docker compose -f docker/docker-compose.yml up -d
# Distributed deployment
docker compose -f docker/docker-compose-distributed.yml up -d
# S3 storage backend
docker compose -f docker/docker-compose-with-s3.yml up -d
Import
# No import needed - Docker Compose files are used directly
# Ensure Docker and Docker Compose are installed
docker compose version
I/O Contract
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| RW_IMAGE | Environment variable | No | RisingWave Docker image (default: risingwavelabs/risingwave:v2.7.1) |
| ENABLE_TELEMETRY | Environment variable | No | Enable/disable telemetry (default: true) |
| RW_SECRET_STORE_PRIVATE_KEY_HEX | Environment variable | No | Secret store encryption key |
| RW_LICENSE_KEY | Environment variable | No | License key for enterprise features |
Outputs
| Name | Type | Description |
|---|---|---|
| Frontend | Port 4566 | PostgreSQL wire protocol endpoint |
| Meta node | Port 5690 | Meta service gRPC endpoint |
| Dashboard | Port 5691 | Built-in web dashboard |
| Grafana | Port 3001 | Grafana dashboards |
| Prometheus | Port 9500 | Metrics endpoint |
| MinIO | Port 9301 | Object storage API |
| Redpanda | Port 29092 | Kafka-compatible message queue |
Usage Examples
Basic Standalone Deployment
# Start the cluster
cd docker
docker compose up -d
# Wait for health checks to pass
docker compose ps
# Connect with psql
psql -h localhost -p 4566 -d dev -U root
# Stop the cluster
docker compose down -v
S3 Storage Backend
# Configure AWS credentials
cat > docker/aws.env << 'EOF'
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
EOF
# Start with S3 backend
docker compose -f docker/docker-compose-with-s3.yml up -d
Related Pages
Implements Principle
Requires Environment
Uses Heuristic
Page Connections
Double-click a node to navigate. Hold to expand connections.
Principle
Implementation
Heuristic
Environment