# Orch8 0.7.0

> Orch8 is a self-hosted durable workflow and portable-continuity engine built in Rust. It runs on PostgreSQL, SQLite, servers, iOS, and Android.

Current release: 0.7.0 (2026-07-28)
Git tag: v0.7.0
Release: https://github.com/orch8-io/engine/releases/tag/v0.7.0

## Start here

- [0.7.0 release and migration guide](/docs/releases/0-7-0)
- [Quick start](/docs/quickstart)
- [Documentation](/docs)
- [REST API guide](/docs/api)
- [Versioning and guarded releases](/docs/versioning)
- [External workers and resumable checkpoints](/docs/workers)
- [Mobile SDK](/docs/mobile)
- [Changelog](/changelog)

## Installation

- Binary: `curl -fsSL https://raw.githubusercontent.com/orch8-io/engine/main/install.sh | sh`
- Docker: `ghcr.io/orch8-io/engine:0.7.0`
- Image index digest: `sha256:80d23764e0dbbd3330ce853e068bf8b6215b6845e167dafcb140c636551aac39`
- Homebrew server: `brew install orch8-io/orch8/orch8-server`
- Homebrew CLI: `brew install orch8-io/orch8/orch8-cli`

Use `v0.7.0` for the Git tag and `0.7.0` for packages, binaries, and container tags.

## 0.7.0 highlights

- Universal effect ledger, commit guards, receipt-backed compensation, and effect-safe provider failover
- Portable Continuity with signed capsules, location history, placement policy, live migration, rollback, provenance, time travel, and what-if analysis
- Lease-safe resumable workers with encrypted 256 KiB checkpoints and compare-and-swap heartbeat updates
- Typed dataflow and deterministic TypeScript, Python, Swift, and Kotlin bindings
- Guarded workflow releases with semantic diff, effect-free validation, canaries, stored-evidence gates, promotion, pause, and rollback
- Bounded Parallel overlap, cooperative priority preemption, stream windows, shared agent memory, human attention, budgets, DLQ reproduction, and fault-lab testing

## Correctness boundary

Orch8 does not claim universal provider-level exactly-once execution. A crash after a provider observes an effect but before the engine commits its receipt leaves an unknown outcome. The fast path is at least once in that window. Use provider idempotency keys, effect receipts, commit guards for declared effect identities, and reconciliation before replay.

## API

Canonical product base: `http://localhost:8080/api/v1`
Generated OpenAPI: `/api-docs/openapi.json`
Swagger UI: `/swagger-ui`

Bare product routes are compatibility aliases. New clients should use `/api/v1`. Authenticated deployments use `x-api-key` and `x-tenant-id` headers.

## Upgrade warnings

- Handoff creation requires `placement_decision_id` and `preview_sha256` from a fresh placement preview.
- Public webhook triggers must have a secret and callers must sign timestamp plus body.
- PostgreSQL migration 074 rewrites and hash-partitions `block_outputs` and `audit_log`; reserve a migration window.
- Source builds require Rust 1.97 or newer.

## Contact

- GitHub: https://github.com/orch8-io
- Cloud: https://cloud.orch8.io
- Email: hello@orch8.io