Skip to main content

Run RisingWave in Docker

This article will help you pull a RisingWave image and run it as a Docker container.

caution

This method starts RisingWave in playground mode, where data is not persisted after the service is terminated.
Start RisingWave in full-featured mode for data persistence and stable performance.
→ See the comparison

Pull and run RisingWave

As prerequisites, you need to install and run Docker Desktop in your environment.

Run the following command to pull and start the latest release of RisingWave in single-binary playground mode.

docker run -it --pull=always -p 4566:4566 -p 5691:5691 risingwavelabs/risingwave:latest playground

You can find the previous releases and nightly builds on Docker Hub.
For example, if you would like to use RisingWave v0.1.17, run:

docker run -it --pull=always -p 4566:4566 -p 5691:5691 risingwavelabs/risingwave:v0.1.17 playground

    If you see the logs, you have successfully started RisingWave.

RisingWave Playground Logs

Connect to RisingWave

After RisingWave is up and running, you need to connect to it via the Postgres interactive terminal psql so that you can issue queries to RisingWave and see the query results.

Open a new terminal window and run:

psql -h localhost -p 4566 -d dev -U root

You can now connect a streaming source to RisingWave and issue SQL queries to manage your data.

Help us make this doc better!