How to remove an instance

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

See also: Instance

This guide demonstrates how to remove an instance, either temporarily or permanently.

Move an instance to the recycle bin

See also: delete, recover

To mark an instance as deleted, run:

$ multipass delete keen-yak

Now, if you list the instances, you will see that it is actually just marked for deletion (or to put it in other words, moved to the recycle bin):

$ multipass list
Name                    State             IPv4             Release
keen-yak                DELETED           --               Not Available

You can move all instances to the recycle bin at once using the --all option:

$ multipass delete --all

Instances that have been marked as deleted can later be recovered:

$ multipass recover keen-yak
$ multipass list
Name                    State             IPv4             Release
keen-yak                STOPPED           --               Ubuntu 18.04 LTS

Remove an instance permanently

See also: delete, purge

If you want to get rid of all instances in the ‘recycle bin’ for good, you must purge them:

$ multipass delete keen-yak
$ multipass purge
$ multipass list
No instances found.

In order to permanently remove only one instance in a single command, you can use:

$ multipass delete --purge keen-yak

---

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