Containers: Use Docker Hub images with Wrangler
Key Points
- Use docker.io image refs in Wrangler
- Private Docker Hub images supported
- No need to push to Cloudflare Registry
Summary
Cloudflare Containers now accept Docker Hub images directly. You can put a fully qualified Docker Hub image reference in your Wrangler configuration and run containers without first pushing the image to Cloudflare Registry.
Key Points
- Reference a Docker Hub image in your wrangler.json / wrangler.toml using the fully qualified name, e.g.
docker.io/<NAMESPACE>/<REPOSITORY>:<TAG>. - Private Docker Hub images are supported; configure credentials as described in the "Use private Docker Hub images" docs and consult "Image management" for additional options.
- Existing Cloudflare Registry workflows remain supported — this adds the option to pull directly from Docker Hub. Avoid using ambiguous tags (e.g.,
latest) for predictable deployments.