0.17.8

tashfeenahmed/freellmapi0.17.8Jun 22, 2026by github-actions[bot]

AI Summary

This release fixes a critical schema change bug from version 0.17.5 that caused crashes during upgrades involving pending transfers. It also includes safety and performance improvements, including fixes for stash overflow and commit stall injection, and adds support for the Ruby client.

Key Highlights

Fixes schema change crash bug affecting upgrades from 0.17.4 to 0.17.5+ with pending transfers.
Fixes stash overflow issues caused by excess tombstones.
Fixes commit stall injection for clusters with 8 or more active clients.
Adds Ruby client publication support.
Adds a gauge metric to record replica start time.

New Features

Ruby client publication support
Gauge metric for replica start time
Case conversion helpers in stdx
stdx.net with IP address implementation
FuzzIterations abstraction for fuzzer smoke tests

Full Release Notes

# 0.17.8

### Supported upgrade versions

Oldest supported client version: 0.16.4
Oldest upgradable replica version: 0.17.4

## Server

* Binary: Download the zip for your OS and architecture from this page and unzip.
* Docker: `docker pull ghcr.io/tigerbeetle/tigerbeetle:0.17.8`
* Docker (debug image): `docker pull ghcr.io/tigerbeetle/tigerbeetle:0.17.8-debug`

## Clients

**NOTE**: Because of package manager caching, it may take a few
minutes after the release for this version to appear in the package
manager.

You cannot run a newer client against an older cluster: clients are only compatible
with replicas from their own release *or newer*, subject to the newer release's
`Oldest supported client version`.

* .NET: `dotnet add package tigerbeetle --version 0.17.8`
* Go: `go mod edit -require github.com/tigerbeetle/tigerbeetle-go@v0.17.8`
* Java: Update the version of `com.tigerbeetle.tigerbeetle-java` in `pom.xml`
  to `0.17.8`.
* Node.js: `npm install --save-exact tigerbeetle-node@0.17.8`
* Python: `pip install tigerbeetle==0.17.8`

## Changelog


This release fixes a schema change bug introduced in 0.17.5, that would cause crashes when
attempting to upgrade to 0.17.5 - 0.17.7 from 0.17.4 and below if pending transfers were
present on the cluster. See [#3808](https://github.com/tigerbeetle/tigerbeetle/issues/3808).

If you are upgrading from 0.17.4, or attempting to upgrade from a currently crashed cluster on
0.17.5 - 0.17.7, no special consideration is needed, and you may upgrade directly to 0.17.8.

If you are upgrading from either a fresh or upgraded cluster on 0.17.5 - 0.17.7, and have used
pending transfers, you can run the script
[here](https://github.com/tigerbeetle/tigerbeetle/issues/3808#issuecomment-4771439967) to check
if you have any blocks that are on the incorrect schema. If you do, please file an issue on GitHub,
otherwise it's safe to upgrade to 0.17.8.

### Safety And Performance

- [a299a](https://github.com/tigerbeetle/tigerbeetle/commit/a299a7d3f7c98793f4c84ee743062bdc720f79ac)

  Fix the headline compatibility bug.

- [#3802](https://github.com/tigerbeetle/tigerbeetle/pull/3802)

  Fix a bug in which the stash would overflow due to excess tombstones.

- [#3798](https://github.com/tigerbeetle/tigerbeetle/pull/3798)

  Fuzz scans over mutable secondary indexes, and fix an assertion.

- [#3797](https://github.com/tigerbeetle/tigerbeetle/pull/3797)

  Fix commit stall injection for clusters with 8 or more active clients.

### Features

- [#3787](https://github.com/tigerbeetle/tigerbeetle/pull/3787)

  Prepare Ruby client for publishing.

- [#3792](https://github.com/tigerbeetle/tigerbeetle/pull/3792)

  Add gauge metric to record replica start time.

### Internals

- [#3795](https://github.com/tigerbeetle/tigerbeetle/pull/3795)

  Add case conversion helpers to `stdx`.

- [#3781](https://github.com/tigerbeetle/tigerbeetle/pull/3781)

  Add `stdx.net` with IP address implementation.

- [#3801](https://github.com/tigerbeetle/tigerbeetle/pull/3801)

  Add `FuzzIterations` abstraction to control fuzzer smoke test duration.

### TigerTracks 🎧

- [The Fallen](https://www.youtube.com/watch?v=YsjHZXRGM1M)

<img width="2732" height="1567" alt="image" src="https://github.com/user-attachments/assets/1f156c1e-2341-43f7-b58f-b59aefde0c5c" />