Workerd Docker Image

Supported Architectures: amd64, arm64

This minimalist Docker image allows you to run a Cloudflare Worker inside a Docker container, offering a simple solution for deploying and testing your worker on your infrastructure.

• Docker Hub
• GitHub Repository

The fastest way to get your Cloudflare Worker running as a Docker container is to use Selflare, which also supports KV, D1, R2, DO, and Cache API out of the box.

npm i -g selflare # Install Selflare
selflare compile # Compile yours worker to Cap'n Proto
selflare docker # Generate Dockerfile and docker-compose.yml
docker compose up # Run the worker

You can now access your worker at http://localhost:8080!

If you prefer to set up the Cap'n Proto manually, follow the steps below.

First, build your worker with Wrangler by running the following command in your project directory:

wrangler deploy --dry-run --outdir .wrangler/dist

This command compiles your worker and outputs the result script to .wrangler/dist/index.js.

Next, create a worker.capnp file in the same directory as your wrangler.toml. This file is used to configure the Workerd runtime. Below is a template you can start with:

using Workerd = import "/workerd/workerd.capnp";
const config :Workerd.Config = (
 services = [
 (name = "main", worker = .worker),
 ],
 sockets = [
 (service = "main", name = "http", address = "*:8080", http = ()),
 ]
);
const worker :Workerd.Worker = (
 modules = [
 (name = "worker", esModule = embed ".wrangler/dist/index.js"),
 ],
 compatibilityDate = "2024-02-19",
);

For detailed information on configuring worker.capnp, refer to the Workerd Repository.

With your worker built and configured, you're ready to run it inside a Docker container. Execute the following command:

docker run -v $(pwd):/worker -p 8080:8080 jacoblincool/workerd

This command mounts your current directory to the /worker directory inside the container and forwards port 8080 to your local machine.

After starting the Docker container, your worker will be accessible at http://localhost:8080.

You can also use this image as a base image for your own worker. Below is an example Dockerfile:

FROM jacoblincool/workerd
COPY worker.capnp worker.capnp
COPY other-file-like-your-worker.js other-file-like-your-worker.js