restart¶
The multipass restart command without any argument will restart the Primary instance (and fail, if it doesn’t exist). You can also pass one or more instance names or the --all option to restart more instances at the same time.
Use the --running-only option to limit the restart operation to the running subset of the input instances.
Note
Only instances in Running, Stopped or Suspended status can be restarted. Stopped instances are simply started, while Suspended instances are resumed first and then are restarted as Running instances.
For example:
multipass restart desirable-earwig
The full multipass help restart output explains the available options:
Usage: multipass restart [options] [<name> ...]
Restart the named instances. If the instance is running, it will be rebooted.
If the instance is suspended, it will be started and then rebooted. If the
instance is stopped, it will be started. Exits with return code 0 when the
instances restart, or with an error code if any fail to restart.
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.
--all Restart all instances
--running-only Avoid restarting non-running instances.
--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
initialization is limited to 5 minutes each.
Arguments:
name Names of instances to restart. If omitted, and without
the --all option, 'primary' will be assumed.