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 a blueprint

See also: Blueprint

Blueprints provide a shortcut to initialising Multipass instances for a variety of applications.

To see what blueprints are available, run

multipass find --only-blueprints

See more: multipass find

To use a blueprint run:

multipass launch <blueprint name>

Launching a blueprint can take the same arguments as launching any other type of instance. If no further arguments are specified, the instance will launch with the defaults defined in the blueprint. Here’s an example of creating an instance from the Docker blueprint with a few more parameters specified:

multipass launch docker --name docker-dev --cpus 4 --memory 8G --disk 50G --bridged

This command will create an instance based on the Docker blueprint, with 4 CPU cores, 8GB of RAM, 50 GB of disk space, and connect that instance to the (predefined) bridged network.

Blueprints also provide a way of exchanging files between the host and the instance. For this, a folder named multipass/<instance name> is created in the user’s home directory on the host and mounted in <instance name> in the user’s home directory on the instance.

See more: multipass launch


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

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