• Logo
    Multipass
  • canonical.com/multipass
  • More resources
    • Discourse
    • Matrix
    • GitHub
Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Multipass documentation
Multipass documentation
  • Home
  • Tutorial
  • How-to guides
    • Install Multipass
    • Manage instances
      • Create an instance
      • Modify an instance
      • 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
      • Use the Docker blueprint
      • Run a Docker container in Multipass
    • Customise Multipass
      • How to set up the driver
      • Migrate from Hyperkit to QEMU on macOS
      • Authenticate clients with the Multipass service
      • Build Multipass images with Packer
      • Set up a graphical interface
      • Use a different terminal from the system icon
      • How to integrate with Windows Terminal
      • Configure where Multipass stores external data
      • Configure Multipass’s default logging level
    • Troubleshoot
      • Access logs
      • Mount an encrypted home folder
      • Troubleshoot launch/start issues
      • Troubleshoot networking
  • Reference
    • Command-line interface
      • alias
      • aliases
      • authenticate
      • clone
      • delete
      • exec
      • find
      • get
      • help
      • info
      • launch
      • list
      • mount
      • networks
      • prefer
      • purge
      • recover
      • restart
      • restore
      • set
      • shell
      • snapshot
      • start
      • stop
      • suspend
      • transfer
      • umount
      • unalias
      • version
    • GUI client
    • Instance name format
    • Instance states
    • Logging levels
    • Settings
      • client.apps.windows-terminal.profiles
      • client.gui.autostart
      • client.gui.hotkey
      • client.primary-name
      • local.bridged-network
      • local.driver
      • local.<instance-name>.bridged
      • local.<instance-name>.cpus
      • local.<instance-name>.disk
      • local.<instance-name>.memory
      • local.<instance-name>.<snapshot-name>.comment
      • local.<instance-name>.<snapshot-name>.name
      • local.passphrase
      • local.privileged-mounts
  • Explanation
    • About performance
    • About security
    • Alias
    • Authentication
    • Blueprint
    • Driver
    • Host
    • ID mapping
    • Image
    • Instance
    • Mount
    • Multipass exec and shells
    • Platform
    • Service
    • Settings keys and values
    • Snapshot
  • Contribute to Multipass docs
Back to top
Give feedback
Contribute to this page

Troubleshoot¶

The following guides provide step-by-step instructions on how to troubleshoot issues with your Multipass installation, beginning by inspecting the logs.

  • Access logs

  • Mount an encrypted home folder

  • Troubleshoot launch/start issues

  • Troubleshoot networking

Copyright © 2025 CC-BY-SA, Canonical Ltd.
Last updated on Feb 20, 2025
Contents
  • Troubleshoot