homebrew-risingwave

Homebrew tap for RisingWave, a distributed SQL database for stream processing.

Installation

Install Homebrew first. Then, tap this repository:

$ brew tap risingwavelabs/risingwave

To install the latest release version:

$ brew install risingwave

Or, to install the latest development version:

$ brew install risingwave --HEAD

You can now start the RisingWave playground and connect to it with the Postgres interactive terminal psql:

$ risingwave playground

# In another terminal...
$ psql -h localhost -p 4566 -d dev -U root

Install old versions

$ brew install risingwave@1.2

# If you haven't installed other versions, it's available as `risingwave`
$ risingwave --version
# If you have installed other versions, you can find it with `brew --prefix`
$ $(brew --prefix risingwave@1.2)/bin/risingwave --version

Maintenance

GitHub Actions

We use the manual GitHub Actions workflow bump risingwave to bump the formula. This requires write access to this repository. The workflow expects a repository secret HOMEBREW_BUMP_PR_TOKEN (PAT or GitHub App token) with permissions to push branches and open PRs.

1. Go to Actions → bump risingwave → Run workflow
2. (Optional) Set version to x.y.z. If left empty, it uses the latest stable release (ignores prereleases).
3. The workflow will open a bump PR that updates:
   • Formula/risingwave.rb version + sha256
   • resource "connector" URL + sha256

If there are existing open bump PRs for the same version, the workflow will close them after the new PR is created.

Bump manually

# 1. Bump the version in the formula
brew bump-formula-pr risingwave --version x.y.z

# 2. Switch to the newly created branch
git switch bump-risingwave-x.y.z

# 3. Manually update the `resource "connector"` section in `Formula/risingwave.rb`
code Formula/risingwave.rb