Public Repository

Last pushed: 21 days ago
Short Description
Base image that makes it easy to dockerize a standard Dart application
Full Description


google/dart-runtime is a docker base image that
makes it easy to dockerize a standard Dart application.

It can automatically bundle a Dart application and its dependencies with
a single line Dockerfile.

It is based on the google/dart-runtime-base base image.


Create a Dockerfile in your Dart application directory with the following

FROM google/dart-runtime

To build a docker image tagged with my/app run:

docker build -t my/app .

To run this image in a container (assuming it is a server application
listening on port 8080):

docker run -d -p 8080:8080 my/app


See the sources for google/dart-hello based on this image.


The image assumes that your application:

  • has the pubspec.yaml file listing its dependencies.
  • has a file named bin/server.dart as the entrypoint script.
  • listens on port 8080
  • all dependent packages can be retrieved when building the container

If you have package dependencies which do not meet the last requirement
take a look at using either the base image google/dart-runtime-base
or google/dart.

Example directory laoyout:


When building your application docker image, ONBUILD triggers fetch the
dependencies listed in the pubspec.yaml file and cache them appropriatly.

Accessing the Observatory

The dart-runtime image enables the
Observatory for the Dart
VM running in the container. The Observatory is listening on the default
port 8181. Just map that port to the host when running the app:

docker run -d -p 8080:8080 -p 8181:8181 my-app

If using boot2docker you can access the Observatory using the docker
host network on (replacing
with what you 'boot2docker ip' says).

Passing VM flags

The dart-runtime image can receive options for the Dart VM through
the environment variable DART_VM_OPTIONS.

docker run -d -p 8080:8080 \
    --env DART_VM_OPTIONS='--old_gen_heap_size=2048 --verbose-gc' \

Using this image with App Engine Managed VMs

If you are using this image with App Engine Managed VMs, the app.yaml
file must be alongside the Dockerfile in the project directory.

You can set up Observatory access by adding the following to the
app.yaml file:

  forwarded_ports: ["8181"]

You can pass VM flags by adding the following to the app.yaml file:

  DART_VM_OPTIONS: --old_gen_heap_size=2048 --verbose-gc
Docker Pull Command