NAME

limactl-shell - Execute shell in Lima

SYNOPSIS

limactl shell [flags] INSTANCE [COMMAND...]

DESCRIPTION

Execute shell in Lima

lima command is provided as an alias for limactl shell $LIMA_INSTANCE. $LIMA_INSTANCE defaults to "default".

By default, the first 'ssh' executable found in the host's PATH is used to connect to the Lima instance. A custom ssh alias can be used instead by setting the $SSH environment variable.

Environment Variables:
--preserve-env: Propagates host environment variables to the guest instance.
Use LIMA_SHELLENV_BLOCK to specify variables to block (prefix with + to extend the default blocklist).
Use LIMA_SHELLENV_ALLOW to exempt specific variables from the blocklist.

Hint: try --debug to show the detailed logs, if it seems hanging (mostly due to some SSH issue).

OPTIONS

-h, --help[=false] help for shell

--preserve-env[=false] Propagate environment variables to the shell

--reconnect[=false] Reconnect to the SSH session

--shell="" Shell interpreter, e.g. /bin/bash

--start[=false] Start the instance if it is not already running

--sync="" Copy a host directory to the guest and vice-versa upon exit

--workdir="" Working directory

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false] Debug mode

--log-format="text" Set the logging format [text, json]

--log-level="" Set the logging level [trace, debug, info, warn, error]

--tty[=false] Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.

-y, --yes[=false] Alias of --tty=false

SEE ALSO

limactl(1)