# deno_docker

**Repository Path**: mirrors_denoland/deno_docker

## Basic Information

- **Project Name**: deno_docker
- **Description**: Latest dockerfiles and images for Deno - alpine, centos, debian, ubuntu
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-07
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# deno_docker

Docker files for [Deno](https://github.com/denoland/deno) published on
[Docker Hub](https://hub.docker.com/r/denoland/deno) and
[GHCR](https://github.com/denoland/deno/pkgs/container/deno):

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

Images are available from both registries:

```sh
docker pull denoland/deno:2.7.14        # Docker Hub
docker pull ghcr.io/denoland/deno:2.7.14 # GHCR
```

---

## Run locally

To start the `deno` repl:

```sh
$ docker run -it denoland/deno:2.7.14 repl
```

To shell into the docker runtime:

```sh
$ docker run -it denoland/deno:2.7.14 sh
```

To run `main.ts` from your working directory:

```sh
$ docker run -it -p 1993:1993 -v $PWD:/app denoland/deno:2.7.14 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

```Dockerfile
FROM denoland/deno:2.7.14

# The port that your application listens to.
EXPOSE 1993

WORKDIR /app

# Cache dependencies as a layer (re-run only when package.json changes).
COPY package.json .
RUN deno install

# 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

# Prefer not to run as root.
USER deno

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

and build and run this locally:

```sh
$ 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.

```Dockerfile
FROM ubuntu
COPY --from=denoland/deno:bin-2.7.14 /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. 

```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`):

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

and in your terminal

```sh
$ 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._