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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]
```

Download binary archives

Restate v1.6.1

This is a strongly recommended patch release for all v1.6.0 users, addressing critical stability and memory issues.

🔧 Critical Stability Fixes

Leadership Thrashing Resolved

In v1.6.0, RocksDB memory rebalancing could block the async runtime for 50–200ms, starving heartbeats and causing nodes to be falsely reported as down — leading to leadership loss and cluster instability. Memory rebalancing is now offloaded to background threads. If you experienced leadership thrashing on v1.6.0, this upgrade should resolve it.

Memory Leak in Networking Layer

Internal RPC callers that timed out could leave stale entries in the reply tracker, causing unbounded memory growth under sustained load. A periodic garbage collection mechanism now cleans these up automatically.

⚠️ Behavioral Change

The default worker.trim-delay-interval changed from 0s to 10m. This gives follower replicas time to catch up before log segments are trimmed, reducing unnecessary re-snapshotting. To restore the old behavior, set worker.trim-delay-interval = "0s" in your config.

🧠 Memory Improvements

• Eliminated high-water-mark buffer retention — Per-invocation protocol encoders no longer retain buffers sized to the largest message ever encoded, reducing memory overhead for clusters with many concurrent long-lived invocations.
• Lazy journal & state reading during replay — Journal entries and state are now read on demand from RocksDB instead of being fully materialized upfront, reducing peak memory during replay of invocations with large journals or state.

✨ New Features

• OTEL_RESOURCE_ATTRIBUTES support — Attach deployment-specific metadata (environment, region, pod name) to all exported traces via the standard environment variable 🔍
• services column in sys_deployment — Query which services belong to which deployment directly via SQL 🗃️
• Weekly Docker image security refreshes — Images are now automatically rebuilt weekly with the latest OS security patches. Use date-suffixed tags (e.g., 1.6.1-20260210) to pin specific builds 🐳

⚡ Performance Improvements

• More efficient invocation cleanup scans
• SQL query push-down filters for faster introspection queries on large tables
• Faster ID encoding (Base62)

🖥️ Web UI Updates (v0.1.46)

• Invocation duration column in the list view
• Paused invocations now show their error/reason directly
• Multiple bug fixes for journal ordering, transient error display, and state page refresh

🔒 Security

• Patched DoS vulnerability in time crate (RUSTSEC-2026-0009)
• Updated bytes crate to address security advisory

📖 Full Release Notes →

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.6.1
docker pull docker.restate.dev/restatedev/restate-cli:1.6.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

Restate v1.6.0 🎉

✨ Release Highlights

⏸️ Pause and Resume for Invocations

Gain explicit control over invocation execution! You can now manually pause running invocations and resume them later — even on a different deployment. Invocations now pause by default when max retries are exhausted, giving you time to investigate issues before deciding to resume, restart, or kill.

# Pause a stuck invocation
restate invocations pause <invocation_id>

# Resume when ready (optionally on a different deployment)
restate invocations resume <invocation_id> --deployment latest

🔄 Restart Invocation from Journal Prefix

Preserve your expensive work when restarting invocations! Keep completed calls, sleeps, and side effects instead of re-executing everything from the beginning. Perfect for recovering from issues without losing progress.

🚀 Deployment Registration Improvements

Safer and more robust deployment workflows:

• Idempotent registration — re-registering the same deployment returns HTTP 200 ✅
• Default force=false — better protection against accidental overwrites
• New breaking flag — allow breaking changes while still protecting against accidents
• Update Deployment API — fix tokens or rotate credentials without re-deploying

🧠 Memory Management Improvements

Better performance with a lower memory footprint out of the box:

• Automatic partition store memory balancing across all active partitions
• Optimized RocksDB defaults (2 GiB total, 85% memtables)
• Reduced query engine memory usage

🔍 Error Events Enabled by Default

Better observability for debugging invocations! When invocations encounter transient failures, Restate now automatically records detailed error information in the journal — visible in the UI invocation timeline and queryable via SQL. See exactly why invocations are failing during retries, including error codes, messages, stacktraces, and the related command that caused the failure.

☁️ Expanded Cloud Provider Support

Simpler cloud deployments with native integrations for AWS, Azure, and GCP:

• Azure Blob Storage & Google Cloud Storage snapshots — store partition snapshots natively in Azure (az://) or GCS (gs://), in addition to Amazon S3

🆕 More New Features

• restate up command — spin up a local Restate server for development with a single command! 🚀
• Kafka SASL OAUTHBEARER/OIDC — connect to Confluent Cloud, Amazon MSK, and Azure Event Hubs 🔐
• Unix Domain Sockets — the server now listens on both TCP and Unix sockets by default 🔌
• Batch invocation operations — operate on hundreds of invocations at once with progress bars 📊

⚠️ Important Breaking Changes

Deprecated SDK Versions Now Rejected

New invocations will be rejected for services using deprecated SDK versions:

• Java/Kotlin < 2.0
• TypeScript <= 1.4
• Go < 0.16
• Python < 0.6
• Rust < 0.4

Existing in-flight invocations continue normally. See migration guidance →

Retry Policy Configuration Migration

The deprecated worker.invoker.retry-policy has been removed. Migrate to invocation.default-retry-policy. Invocations now pause by default when max attempts are reached.

Helm Chart Resource Limits Increased

Default resource limits increased to 8Gi memory / 4 CPU. A default value of 3Gi is now specified for RESTATE_ROCKSDB_TOTAL_MEMORY_SIZE. Check your cluster has sufficient resources before upgrading.

restate cloud env tunnel changes

The Cloud Tunnel now operates as a reverse proxy, instead of routing to a specific local port:

restate cloud env tunnel --tunnel-name my-tunnel
restate dp register --tunnel-name my-tunnel http://localhost:9080
# you can even proxy to external urls
restate dp register --tunnel-name my-tunnel https://my-worker.workers.dev

📖 Full Release Notes →

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.6.0
docker pull docker.restate.dev/restatedev/restate-cli:1.6.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

Restate v1.6.0-rc.5

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.6.0-rc.5
docker pull docker.restate.dev/restatedev/restate-cli:1.6.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

Restate v1.6.0-rc.4

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.6.0-rc.4
docker pull docker.restate.dev/restatedev/restate-cli:1.6.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

Restate v1.6.0-rc.3

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.6.0-rc.3
docker pull docker.restate.dev/restatedev/restate-cli:1.6.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

Restate v1.5.6

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.5.6
docker pull docker.restate.dev/restatedev/restate-cli:1.5.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

What's changed:

• Minor bug fix 7d05506

Full Changelog: v1.5.5...v1.5.6

Restate v1.5.5

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.5.5
docker pull docker.restate.dev/restatedev/restate-cli:1.5.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

What's Changed

• Support migration to DynamoDB metadata store from replicated store #4062

Full Changelog: v1.5.4...v1.5.5

Restate v1.5.4

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.5.4
docker pull docker.restate.dev/restatedev/restate-cli:1.5.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

What's Changed

• Add support to DynamoDB metadata store provider #3951

Restate v1.5.3

Install

Pull the Docker images

docker pull docker.restate.dev/restatedev/restate:1.5.3
docker pull docker.restate.dev/restatedev/restate-cli:1.5.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/[email protected]
npm install @restatedev/[email protected]
npm install @restatedev/[email protected]

Download binary archives

What's Changed

• Fix old retry policy setup by @slinkydeveloper in #3912

Full Changelog: v1.5.2...v1.5.3