Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

How to use the Docker blueprint

The Docker blueprint gives Multipass users an easy way to create Ubuntu instances with Docker installed. It is based on the latest LTS release of Ubuntu, and includes docker engine and Portainer. The Docker blueprint automatically aliases the docker and docker-compose commands to your host, and creates a workspace that is shared between the host and the instance.

To use the Docker blueprint, run multipass launch docker, which will launch an instance with default parameters.

Next, follow the instructions in the output to add the aliased command to your path, it should look something like this:

You'll need to add this to your shell configuration (.bashrc, .zshrc or so) for

aliases to work without prefixing with `multipass`:

PATH="$PATH:/home/user/snap/multipass/common/bin"

Running which docker from your host command line should confirm that you are running Docker inside Multipass.

To access Portainer, run multipass ls and copy the IP address of the multipass instance (the first in the list), then enter it into your browser followed by a colon and Portainer’s port number, 9000 (something like this: 10.21.145.191:9000). This gives you Portainer’s web interface for visually managing your containers.

You can mount files into this instance as with any Multipass instance, but the default shared workspace is an easy way to edit your dockerfiles and docker-compose.yaml files from your host. With working directory mapping, you can run the docker-compose command from your host inside the shared directory, and have it run within that same directory in your Multipass instance.


Errors or typos? Topics missing? Hard to read? Let us know or open an issue on GitHub.

Last updated 2 months ago. Help improve this document in the forum.