How to use the Docker blueprint

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

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 will be able to run the docker-compose command from your host inside the shared directory, and have it execute within that same directory in your Multipass instance.


Let us know how this worked for you and what you’d like to see next!

Last updated 14 days ago. Help improve this document in the forum.