Software Releases

These documents explain the steps involved in updating RudderStack Data Plane.

Data Plane consists of two software components:

  • Backend

  • Transformer

Backend is written in Golang whereas Transformer is written in Javascript. Each project is maintained as a separate repository in GitHub.

Semantic Versioning

Every release of the software will be given a version number. We strictly follow https://semver.org/ for versioning the software release.

A normal version number will take the form X.Y.Z where X, Y and Z are non-negative integers, and will not contain leading zeros. X stands for the major version, Y stands for the minor version and Z stands for the patch version.

For every new release these elements will increase numerically based on the release.

We add an optional letter 'v' before a semantic version to indicate it as a version number. So name of any software release from Rudder will be of the form "vX.Y.Z".

For more about Semantic Versioning please visit https://semver.org.

Backend Releases

Download latest binary from GitHub.

All the releases made will be under the releases tab. Look for the stable latest release listed on the top. Expand the Assets List. You should look at something like below.

Downloading the Latest Backend Releases

Pick an appropriate release that works on your target OS and system architecture. For example, if you are running 64-bit Ubuntu OS then download *_Linux_x86_64.tar.gz.

Extract the downloaded tar ball to get the Backend binary. Update your deployment pipeline to use the new binary.

Transformer Releases

Download latest release from GitHub.

All the releases made will be under the releases tab. Look for the stable latest release listed on the top. Expand the Assets List. You should look at something like below.

Downloading the Latest Transformer Releases

Pick the latest stable release and download the zipped file/tar ball. Extract the zip/tar to get the latest software.

Update your deployment pipeline to run npm install and use the new source.

Version Compatibility

For Rudder stack to work without issues, Backend and Transformer should be compatible with each other.

A version of Backend and a version of Transformer are compatible with each other if they have the same major and minor element in their version names.

Please refer to this page for any future updates on version compatibility.