(how-to-guides-index)=

How-to guides

The following how-to guides provide step-by-step instructions on the installation, use, management and troubleshooting of Multipass.

Install and deploy Multipass

Installing Multipass is a straightforward process but may require some prerequisite steps, depending on your host system. You can find specific installation instructions for your operating system in this guide:

• How to install Multipass

Manage instances

Multipass allows you to create Ubuntu instances with a single command. As your needs grow, you can modify and customise instances via different options or with the use of cloud-init files: <!--- This line added by @nielsenjared -->

• Create an instance
• Modify an instance
• Launch customized instances with Multipass and cloud-init
• Use an instance
• Use the primary instance
• Use instance command aliases
• Share data with an instance
• Remove an instance
• Add a network to an existing instance
• Configure static IPs
• Use a blueprint (removed)
• {ref}how-to-guides-manage-instances-use-the-docker-blueprint
• Run a Docker container in Multipass

Customise Multipass

You may also want to customise Multipass to address specific needs, from managing Multipass drivers to configuring a graphical user interface:

• Set up the driver
• Migrate from Hyperkit to QEMU on macOS
• Authenticate users with the Multipass service
• Build Multipass images with Packer
• Set up a graphical interface
• Use a different terminal from the system icon
• Integrate with Windows Terminal
• Configure where Multipass stores external data
• Configure Multipass’s default logging level

Troubleshoot

Use the following how-to guides to troubleshoot issues with your Multipass installation, beginning by inspecting the logs: <!--- This line added by @nielsenjared -->

• Access logs
• Mount an encrypted home folder
• Troubleshoot launch/start issues
• Troubleshoot networking

:hidden:
:titlesonly:
:maxdepth: 2
:glob:

install-multipass
manage-instances/index
customise-multipass/index
troubleshoot/index