Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Cloudflare Serverless Registry

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.5 Club score Visit github.com

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.

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