Disclaimer

• Instructions written for Redhat - not an endorsement of Redhat, if you can avoid using Redhat, please do 😃. An AI agent like claude code can definitely adapt this to whatever OS you’re using for you!
• not for PROD
• This is not a perfect simulation for PROD. PROD will be with k8s, which RisingWave is built for. PROD will be a smoother and more performant experience.
• This sample uses MinIO, which is taking up disk and cpu. It is also adding complexity. Please use s3 if that is what you will use for your PROD deployment. Most RisingWave customers use s3.
• Allow 20% CPU overhead for podman-compose (only allocate 80% of the CPUs to the cluster).
  • keep a 1:4 ratio CPU: RAM for each RisingWave node (meta, frontend, compute, compactor)

Tips

• use the RisingWave slack runLLM app ****to help you with the scripting and answer questions specific to RisingWave
• send your favorite LLM/ agent a copy of these instructions, then you can ask it questions and have it help you make adjustments
• please keep a shared doc with the RisingWave team that outlines your deployment. This way, the RisingWave team will be able to have context to help you! Otherwise, we may accidentally give you answers for k8s deployments.

Goal

• deploy a podman-compose dev cluster for more aggressive testing on real data before we proceed to prod with k8s

Diagram

Instructions

1. Import Files:

   EASY (Redhat only) : Create the directory where you want to host RisingWave and unzip files into it

   mkdir rw_project_cluster
   
   curl -L <https://github.com/rmbeddor14/podman-compose-jan-2026/tarball/main> \\
   | tar -xz -C rw_project_cluster --strip-components=1
   
   cd rw_project_cluster
   
   

   or, MANUALLY:

   • a. Add the yaml for risingwave as compose.yaml
   • b. Add prometheus.yaml to the directory- note make sure the ports match your compose.yaml if you have modified anything
   • c. Add grafana-risedev-dashboard.yaml to the directory
   • d. Add grafana-risedev-datasource.yaml to the directory
   • e. Add grafana.ini to the directory
   • f. Add a risingwave.toml file to the directory
   • g. Add a directory called dashboards and wget the dashboards:

2. podman-compose up -d

3. Connect to RisingWave with psql -h 0.0.0.0 -p 4566 -d dev -U root