Cloudflare Serverless Registry
github.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What Cloudflare Serverless Registry is
Cloudflare Serverless Registry is a container registry implementation that runs in Cloudflare Workers and uses R2. It supports pushing and pulling container images, including Docker login, push, and pull workflows. Authentication supports username and password or public-key JWT. When an image is missing from its R2 bucket, the registry can retrieve it from another registry and copy it into R2 for later pulls; fallback pulls support Basic and Bearer authentication. Deployment instructions use Wrangler to configure a Cloudflare Worker and an R2 bucket. The README directs users to store registry passwords and tokens as Wrangler secrets, not in the configuration file. The project is licensed under Apache License 2.0. The registry itself has no separate price listed, while R2 usage may incur charges beyond its included monthly allowance of 10 GB-month of Standard storage, 1 million Class A requests, and 10 million Class B requests. Docker pushes are limited to image layers no larger than 500MB. JWT tokens have no per-account or per-repository scope, so a verified token's capabilities apply across the registry. The README lists pnpm as the only supported package manager, though others may work.
Who it suits
This project suits teams that want a container registry backed by Cloudflare Workers and R2 and are comfortable deploying it with Wrangler. Its registry-wide JWT permissions are important to account for when deciding how to use it.
Good to know, and what to watch
- Supports Docker image push and pull workflows.
- Can copy missing images from another registry.
- Supports password and public-key JWT authentication.
- Apache License 2.0 project license.
- R2 includes a stated monthly free allowance.
- JWT capabilities are not scoped per account or repository.
- Docker push layers are limited to 500MB.
- pnpm is the only supported package manager.
- R2 usage may incur charges beyond its free allowance.
Plans
Every plan and priceCloudflare R2 usage-based charges
Free plan
The verdict
Cloudflare Serverless Registry provides image push and pull workflows with R2 storage and registry fallback. Review the JWT scope and push-size limit, and account for potential R2 charges.
What the maker publishes
- Authentication
- It supports username/password and public-key JWT authentication. source
- Credential handling
- The README directs users to store registry passwords and tokens as Wrangler secrets rather than in the Wrangler configuration file. source
- Dependency support
- The README says pnpm is the only supported package manager, though other package managers may work. source
- Deployment
- The deployment instructions configure a Cloudflare Worker and an R2 bucket using Wrangler. source
- Docker
- The README shows using Docker login, push, and pull with the registry. source
- Fallback authentication
- Pull fallback supports Basic and Bearer authentication. source
- Founded
- 2009 source
- Founded
- 2024 source
- Free R2 allowance
- Cloudflare R2 includes 10 GB-month of Standard storage, 1 million Class A requests, and 10 million Class B requests each month at no charge. source
- Headquarters
- San Francisco, CA source
- JWT scope
- The README says JWT tokens have no per-account or per-repository scoping, and a verified token grants its capabilities across the whole registry. source
- License
- The repository is licensed under the Apache License 2.0. source
- Purpose
- The project provides a container registry implementation in Cloudflare Workers backed by R2. source
- Push and pull
- It supports container image pushing and pulling workflows. source
- Push size limit
- Docker pushes are limited to images whose layers are at most 500MB, with the README referring to Workers plan request body limits. source
- Registry fallback
- It can fetch images missing from its R2 bucket from another registry and copy them into R2 for later pulls. source
- Security reporting
- The repository security policy directs vulnerability reports to Cloudflare's disclosure program or [email protected]. source
Checked against the maker's pages on 4 Oct 2026.