Restate v1.7.2

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.2
docker pull docker.restate.dev/restatedev/restate-cli:1.7.2

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.2
npm install @restatedev/restate@1.7.2
npm install @restatedev/restatectl@1.7.2

Download binary archives

Restate v1.7.1

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.1
docker pull docker.restate.dev/restatedev/restate-cli:1.7.1

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.1
npm install @restatedev/restate@1.7.1
npm install @restatedev/restatectl@1.7.1

Download binary archives

Restate v1.7.0 🎉

✨ Release Highlights

🚦 Flow Control

Restate begins shipping its flow-control primitives! v1.7 introduces the first building block — concurrency limits driven by a request scope, exposed through new /restate/ ingress endpoints and managed with the new restate rules commands. Cap how much expensive work runs at once — especially valuable for AI agents (each concurrent invocation can mean real model/API spend) and for protecting downstream services from bursts. More flow-control capabilities will follow.

experimental_enable_vqueues = true

# Default of 1000 concurrent invocations per scope, tighter 50-cap for "checkout"
restate rules set "*" --concurrency 1000 --description "scope default"
restate rules set "checkout" --concurrency 50

☁️ Native Google Cloud Run Authentication

HTTP deployments can now opt into native Google OIDC ID-token authentication. Restate mints short-lived, audience-scoped, Google-signed tokens for every discovery and invocation request; replacing the pattern of embedding long-lived bearer tokens in deployment headers (no rotation, no audit story).

restate dp register https://svc-abc-uc.a.run.app --gcp-id-token

🐝 Dynamic Kafka Cluster Management

Configure KafkaClusters dynamically through the Admin API and CLI instead of baking them into static restate.toml configuration. Both clusters and subscriptions are now manageable from the restate CLI.

restate kc create my-cluster bootstrap.servers=broker:9092 security.protocol=SASL_SSL
restate sub create kafka://my-cluster/orders service://Counter/count group.id=g1

🧠 Bounded Invoker Memory Pool

The invoker now runs under a bounded memory pool (default 1.5 GiB) that limits in-flight data flowing from the server to deployments. This adds backpressure and protects nodes from out-of-memory conditions under bursts of large payloads or state.
This makes the system more predictable under load, with no configuration required.

🎨 Restate UI 1.0

The bundled Restate web UI graduates from 0.x to v1.0 — a complete new layout, better observability features, and much more. The UI ships with every server release, so the upgrade lands automatically with no configuration.

🆕 More New Features

• Service Protocol v7 — opt-in wire protocol with richer failure handling (pause / fail) and better suspension visibility 🧪
• HTTP/2 connection pool for service invocations — concurrency to a deployment is no longer capped by a single connection's max_concurrent_streams 🔗
• Partition leadership control — pin or freeze partition leaders via restatectl partition leader 📌
• Configurable idempotency & workflow retention — new default-* / max-* retention knobs ⏱️
• Manual RocksDB compaction — restatectl storage compact to reclaim disk space 🧹

⚠️ Important Breaking Changes

Snapshot Retention Graduated Out of Experimental

worker.snapshots.experimental-num-retained is replaced by num-retained (now non-optional, default 1). Rename the key before upgrading. latest.json is now always written in V2 format. See migration guidance →

Ingress Request Size Limit Enforced

The HTTP ingress now rejects request bodies larger than networking.message-size-limit (32 MiB by default) with 413 Payload Too Large before reaching the handler. Raise the cap via the new ingress.request-size-limit if needed. See migration guidance →

Per-Database RocksDB Background Work Budgets

rocksdb-max-background-jobs is removed from the shared rocksdb block. Background work is now controlled per-database (separate flush/compaction limits, auto-computed from CPU count and active roles). The global rocksdb-bg-threads / rocksdb-high-priority-bg-threads options were also renamed. See migration guidance →

Also deprecated this release: disable_eager_state (use eager-state-size-limit = "0") and the root-level service-client options (moved under worker.invoker; the root location still works but is removed in v1.8).

📖 Full Release Notes →

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0
npm install @restatedev/restate@1.7.0
npm install @restatedev/restatectl@1.7.0

Download binary archives

Restate v1.7.0-rc.6

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.6
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.6

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.6
npm install @restatedev/restate@1.7.0-rc.6
npm install @restatedev/restatectl@1.7.0-rc.6

Download binary archives

Restate v1.7.0-rc.5

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.5
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.5

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.5
npm install @restatedev/restate@1.7.0-rc.5
npm install @restatedev/restatectl@1.7.0-rc.5

Download binary archives

Restate v1.7.0-rc.4

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.4
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.4

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.4
npm install @restatedev/restate@1.7.0-rc.4
npm install @restatedev/restatectl@1.7.0-rc.4

Download binary archives

Restate v1.7.0-rc.3

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.3
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.3

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.3
npm install @restatedev/restate@1.7.0-rc.3
npm install @restatedev/restatectl@1.7.0-rc.3

Download binary archives

Restate v1.7.0-rc.2

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.2
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.2

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.2
npm install @restatedev/restate@1.7.0-rc.2
npm install @restatedev/restatectl@1.7.0-rc.2

Download binary archives

Restate v1.7.0-rc.1

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.7.0-rc.1
docker pull docker.restate.dev/restatedev/restate-cli:1.7.0-rc.1

Install prebuilt binaries via Homebrew

brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl

Install prebuilt binaries into your npm project

npm install @restatedev/restate-server@1.7.0-rc.1
npm install @restatedev/restate@1.7.0-rc.1
npm install @restatedev/restatectl@1.7.0-rc.1

Download binary archives

Restate v1.6.2

This patch release fixes a critical bug affecting lazy state users and includes several other bug fixes and improvements.

🐛 Critical Bug Fix: Lazy State Keys Encoding

If you are using lazy state (enableLazyState: true) and your handler calls ctx.stateKeys(), invocations could get stuck in a retry loop with a journal mismatch error (code 570) after suspending and resuming. The server was incorrectly storing GetLazyStateKeys commands as GetLazyState commands in the journal.

Note: This only affects handlers with lazy state enabled that call ctx.stateKeys(). Handlers using eager state or only ctx.get(key) are not affected. The Java SDK is also not affected.

After upgrading, new invocations work correctly. Existing stuck invocations have a corrupted journal and need to be resolved manually:

1. Kill and re-invoke: restate invocations cancel --kill <INVOCATION_ID>
2. Or apply an SDK-side fix (sdk-shared-core#60) that tolerates the mismatch during replay

🔧 Other Bug Fixes

• SQL query predicate tolerance — Fixed a crash when DataFusion generated predicates with incorrect column indices for introspection table queries (#4389)
• Fix clamp_max return value — Fixed incorrect reporting that a value was clamped when it was within the allowed range, which could cause spurious warnings during metadata schema processing

⚙️ Helm Chart: image.tag and image.digest

The version field in Helm chart values is now deprecated in favor of image.tag. A new image.digest field enables pinning images by SHA digest for reproducible deployments.

# New approach (replaces deprecated "version" field):
image:
  tag: "1.6.2"
# Or pin by digest:
image:
  digest: "sha256:abc123..."

Precedence: image.digest > image.tag > version. The version field continues to work for backward compatibility.

🖥️ Web UI Updates (v0.1.49)

• Added support for displaying lazy state entries
• Fixed display of lazy state keys entries
• Minor UI improvements

📖 Full Release Notes →

Install

Pull the Docker images

```sh
docker pull docker.restate.dev/restatedev/restate:1.6.2
docker pull docker.restate.dev/restatedev/restate-cli:1.6.2
```

Install prebuilt binaries via Homebrew

```sh
brew install restatedev/tap/restate-server
brew install restatedev/tap/restate
brew install restatedev/tap/restatectl
```

Install prebuilt binaries into your npm project

```sh
npm install @restatedev/restate-server@1.6.2
npm install @restatedev/restate@1.6.2
npm install @restatedev/restatectl@1.6.2
```

Download binary archives