Installing other versions

This guide explains how to install a specific version of Ribasim, such as a pre-release (release candidate) or an older stable release. For installing the latest stable release, see the Installation page.

Important

All Ribasim component versions must be the same!

The Ribasim core, Ribasim Python package, and Ribasim QGIS plugin must all be of the same version. Running with mismatched versions will likely fail.

1 Choosing a version

Ribasim uses the following versioning scheme:

  • Releases have version numbers like 2025.6.0.
  • Pre-releases (release candidates) have version numbers like 2026.1.0-rc1. These are development versions used for testing before a stable release.

Note that X-rcY is an earlier version than X — the -rcY suffix indicates it is a release candidate that preceded the final release.

Warning

Pre-releases are not officially supported. Use them at your own risk and prefer a stable release for production use.

Browse the GitHub releases page to see all available versions. Pre-releases are marked with a “Pre-release” label.

2 Install a specific Ribasim core version

Download the appropriate zip file for your operating system from the GitHub releases page. Navigate to the desired version and download:

  • ribasim_windows.zip for Windows
  • ribasim_linux.zip for Linux

For example, to install version 2026.1.0-rc1, go to the v2026.1.0-rc1 release and download the zip file from there.

Then follow the manual installation instructions to extract and set up the binary.

3 Install a specific Ribasim Python version

Replace the version number in the install command with the desired version. If you don’t have a project set up yet, follow the initialization steps on the Installation page first.

uv add ribasim==2026.1.0-rc1
pixi add --pypi ribasim==2026.1.0-rc1
Note

Pre-releases are only published to PyPI, so you must use the --pypi flag when installing a pre-release with pixi.

pip install --upgrade ribasim==2026.1.0-rc1
Important

Pre-releases are only published to PyPI, not to conda-forge. For pre-release versions, use uv, pixi, or pip instead.

For stable releases, see the standard conda installation instructions.

4 Install a specific Ribasim QGIS plugin version

The QGIS Plugin Repository installs the latest stable release of the Ribasim QGIS plugin. To install a specific version, use the ZIP file method:

  1. Go to the GitHub releases page and navigate to the desired version.
  2. Download ribasim_qgis.zip from the release assets.
  3. In QGIS, go to Plugins > Manage and Install Plugins… > Install from ZIP.
  4. Browse to the downloaded ribasim_qgis.zip and click Install Plugin.

See the QGIS plugin installation instructions for more details on installing from ZIP.