shell¶
The multipass shell command will open a shell prompt on an instance. Without any arguments, it will open the shell prompt of the Primary instance (and also create it, if it doesn’t exist). You can also pass the name of an existing instance. If the instance is not running, it will be started automatically.
If you run multipass shell you’ll find yourself in the primary instance:
Welcome to Ubuntu 26.04 LTS (GNU/Linux 7.0.0-15-generic x86_64)
* Documentation: https://docs.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/pro
System information as of Tue Jun 9 15:54:32 UTC 2026
System load: 0.4 Processes: 123
Usage of /: 67.7% of 3.70GB Users logged in: 0
Memory usage: 29% IPv4 address for eth0: 10.97.0.49
Swap usage: 0%
Expanded Security Maintenance for Applications is not enabled.
0 updates can be applied immediately.
Enable ESM Apps to receive additional future security updates.
See https://ubuntu.com/esm or run: sudo pro status
To open a shell in an existing instance, run the command:
multipass shell <instance name>
The full multipass help shell output explains the available options:
Usage: multipass shell [options] [<name>]
Open a shell prompt on the instance.
Options:
-h, --help Displays help on commandline options
-v, --verbose Increase logging verbosity. Repeat the 'v' in the short
option for more detail. Maximum verbosity is obtained
with 4 (or more) v's, i.e. -vvvv.
--timeout <timeout> Maximum time, in seconds, to wait for the command to
complete. Note that some background operations may
continue beyond that. By default, instance startup and
initialisation is limited to 5 minutes each.
Arguments:
name Name of the instance to open a shell on. If omitted,
'primary' (the configured primary instance name) will be
assumed. If the instance is not running, an attempt is
made to start it (see `start` for more info).