---
title: "Changelog"
description: "Where to find the release history of cf-orbs."
---

> Documentation Index
> Fetch the complete documentation index at: https://cf-orbs-site.mdick85.workers.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

The full history is in [CHANGELOG.md](https://github.com/meirdick/cf-orbs/blob/main/CHANGELOG.md) in the repo, which follows Keep a Changelog. The project uses Semantic Versioning, and before 1.0 a minor version can break the config or the control-plane API.

## Recent releases

| Version | Date | Main changes |
| --- | --- | --- |
| 0.2.5 | 2026-11-10 | A slow provider container is restarted automatically. Dispatch starts 2 processes for a job, not 25. New option `providerInstance`. `status` and `doctor` answer when the provider is slow |
| 0.2.4 | 2026-11-03 | `init` stops instead of overwriting an existing Worker from a new folder. New flag `--adopt` |
| 0.2.3 | 2026-11-03 | Default Amp provider name is `cloudflare`. `init` prints what to back up. New guide: [Back up and restore](/docs/guides/back-up-and-restore/) |
| 0.2.2 | 2026-11-03 | `init` names the Amp token page and warns on a fallback provider name. Internal codes removed from shipped comments. Example config lists 4 more keys |
| 0.2.1 | 2026-11-02 | Fix: `cf-orbs doctor` reads the provider Dockerfile from the source when templates are not built |
| 0.2.0 | 2026-11-02 | `init --no-deploy` (Workers Builds, no Docker). `init --name`. Plan check and orb self-test in `init`. New `doctor` file checks. `upgrade --no-deploy` |
| 0.1.1 | 2026-11-02 | Fix: `bin` path in `package.json` |
| 0.1.0 | 2026-11-02 | First public release. Warm pause, prewarm, huge pages, `fastTmpfsGb`, `projectSnapshotRefresh`, `snapshots prune`, `init --vcpu` |

## Upgrade notes

To upgrade from 0.1.x to 0.2.x, run `npx cf-orbs@latest upgrade` or `npx cf-orbs@latest deploy`. The config doesn't change and paused orbs survive. The provider restarts once, and only if its image changed. See [Upgrade](/docs/guides/upgrade/).

Releases are on [GitHub](https://github.com/meirdick/cf-orbs/releases) and the `cf-orbs` package is on npm.

Source: https://cf-orbs-site.mdick85.workers.dev/docs/changelog/index.mdx