---
title: "Overview"
description: "cf-orbs runs Amp orbs in your own Cloudflare account. What it is, why you'd use it, and where to start."
---

> 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.

# Overview

cf-orbs runs [Amp](https://ampcode.com) orbs in your own Cloudflare account. An orb is the machine where an Amp agent runs its tools: it clones your repo, runs commands and edits files there. Amp runs orbs on its own servers by default. With cf-orbs, each orb is a Cloudflare Container in your account instead.

## Why use it

- **Your code stays in your account.** The repo checkout, build output and saved disks stay in your Cloudflare account.
- **You pay only for what runs.** A paused orb has no compute charge. You pay $5 a month for the Workers Paid plan and about $2 a month for the provider (the always-on process that takes orb jobs from Amp). Each awake default orb costs $0.113 an hour. See [Costs](/docs/concepts/costs/).
- **One command to install.** `npx cf-orbs init` deploys cf-orbs to your account.

## Features

- It starts, pauses and resumes orbs when Amp asks, and keeps the disk across a pause.
- Each install has one orb size, up to 4 vCPU and 12 GiB memory.
- You can add your own toolchains to the orb image.
- `cf-orbs doctor` and a self-test check the install.
- The CLI handles upgrades, token rotation, snapshots and uninstall.

## Where to go next

- **Quickstart** — Install cf-orbs and run a first orb. [Start here](/docs/quickstart/).
- **How it works** — The parts and how a job moves through them. [Read](/docs/concepts/how-it-works/).
- **Limits and FAQ** — What cf-orbs doesn't do, and how it compares with Amp-hosted orbs. [Open](/docs/limits-and-faq/).
- **Troubleshooting** — Real error messages, what causes them and how to fix them. [Open](/docs/troubleshooting/).

cf-orbs is a community project. It is not affiliated with Cloudflare or Amp (Sourcegraph).

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