denoland/deno repository overview

⁠deno_docker

Docker files for Deno⁠ published on Dockerhub:

• Alpine Linux: denoland/deno:alpine⁠
• Debian: denoland/deno:debian⁠ (default)
• Distroless: denoland/deno:distroless⁠
• Ubuntu: denoland/deno:ubuntu⁠
• Only the binary: denoland/deno:bin⁠

⁠Run locally

To start the deno repl:

$ docker run -it denoland/deno:2.6.10 repl

To shell into the docker runtime:

$ docker run -it denoland/deno:2.6.10 sh

To run main.ts from your working directory:

$ docker run -it -p 1993:1993 -v $PWD:/app denoland/deno:2.6.10 run --allow-net /app/main.ts

Here, -p 1993:1993 maps port 1993 on the container to 1993 on the host, -v $PWD:/app mounts the host working directory to /app on the container, and --allow-net /app/main.ts is passed to deno on the container.

⁠As a Dockerfile

FROM denoland/deno:2.6.10

# The port that your application listens to.
EXPOSE 1993

WORKDIR /app

# Prefer not to run as root.
USER deno

# Cache the dependencies as a layer (the following two steps are re-run only when deps.ts is modified).
# Ideally cache deps.ts will download and compile _all_ external files used in main.ts.
COPY deps.ts .
RUN deno install --entrypoint deps.ts

# These steps will be re-run upon each file change in your working directory:
COPY . .
# Compile the main app so that it doesn't need to be compiled each startup/entry.
RUN deno cache main.ts

CMD ["run", "--allow-net", "main.ts"]

and build and run this locally:

$ docker build -t app . && docker run -it -p 1993:1993 app

⁠Using your own base image

If you prefer to install deno in your own base image, you can use the denoland/deno:bin to simplify the process.

FROM ubuntu
COPY --from=denoland/deno:bin-2.6.10 /deno /usr/local/bin/deno

⁠Running on Google Cloud Run(GCR)

Due to conflicts with google cloud run caching mechanism it's required to use different path for DENO_DIR in your Dockerfile.

# set DENO_DIR to avoid conflicts with google cloud
ENV DENO_DIR=./.deno_cache

Without it GCR instance will try to download deps every time. When running with --cached-only you will get Specified not found in cache.

⁠(optional) Add deno alias to your shell

Alternatively, you can add deno command to your shell init file (e.g. .bashrc):

deno () {
  docker run \
    --interactive \
    --tty \
    --rm \
    --volume $PWD:/app \
    --volume $HOME/.deno:/deno-dir \
    --workdir /app \
    denoland/deno:2.6.10 \
    "$@"
}

and in your terminal

$ source ~/.bashrc
$ deno --version
$ deno run ./main.ts

See example directory.

Note: Dockerfiles provide a USER deno and DENO_DIR is set to /deno-dir/ (which can be overridden).

If running multiple Deno instances within the same image you can mount this directory as a shared volume.

⁠Thanks

Thanks to Andy Hayden⁠ for maintaining and setting up these images.