Run RisingWave locally
This article will help you start a RisingWave standalone instance in your environment.
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
Install and start RisingWave
You can download the pre-built library or build from the latest source code:
- Pre-built package (Linux)
- Build from source (Linux & macOS)
Download the pre-built binary.
You can find previous binary releases in Release notes.
Unzip the binary.
tar xvf risingwave-v0.1.17-x86_64-unknown-linux.tar.gz
Start RisingWave in playground mode.
Clone the risingwave repository and enter the directory.
git clone https://github.com/risingwavelabs/risingwave.git && cd risingwave
RisingWave has the following dependencies. Please ensure all the dependencies have been installed before running RisingWave.
- Protocol Buffers
- psql (14.1 or higher)
Select your operating system and run the following commands to install the dependencies.
brew install libpq cmake protobuf openssl tmux cyrus-sasl
brew link --force libpq
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shnote
If you are using a Mac with Apple silicon (such as the M1 / M2 chip), you need to install
brew install llvm.
sudo apt update
sudo apt upgrade
sudo apt install make build-essential cmake protobuf-compiler curl openssl libssl-dev libsasl2-dev libcurl4-openssl-dev pkg-config postgresql-client tmux lld
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
To compile and start RisingWave, you can use RiseDev, the developer's tool for RisingWave.
./risedev playground #Or ./risedev p
If you see the logs, you have successfully started RisingWave.
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.