MACHINECTL(1) machinectl MACHINECTL(1) (NAME) machinectl - (SYNOPSIS) machinectl [OPTIONS...] {COMMAND} [NAME...] (DESCRIPTION) machinectl systemd(1) systemd- machined.service(8) . machinectl . : o (VM) ( ) . o . o . DNS . . -- -- . : o /usr/ /etc/ . o btrfs . o ("raw") MBR GPT . o MBR GPT . o . importctl(1) (import) (export) . (COMMANDS) : (Machine Commands) list (). list-images ( ) . ".host" . --all . 206. status NAME... (journal). . show . . 206. show [NAME...] . . NAME . . --all . --property= . (cgroup) . status . 206. start NAME... systemd-nspawn(1). systemd-nspawn@.service systemctl start . systemd-nspawn /var/lib/machines/ ( ) . list-images ( ) . systemd- machined.service(8) systemd-nspawn . machinectl systemd-nspawn. . systemd-nspawn . machinectl poweroff . 219. login [NAME] (login) . . ".host" ( ) . TTY getty . systemd(1) init . (login prompt) . shell ( ) systemd-run(1) --machine= . 209. shell [[NAME@]NAME [PATH [ARGUMENTS...]]] (shell) . . ".host" ( ) . login . /bin/sh . --uid= "@" . --setenv= . machinectl shell / . systemd-run ( ). shell ( ) su(1) su . utmp (audit) (keyring) . systemd-run(1) --machine= machinectl shell / . --wait systemd-run . --pty systemd-run machinectl shell . systemd-run . systemd-run machinectl shell . 225. enable NAME..., disable NAME... systemd-nspawn(1). systemd-nspawn@.service systemctl enable systemctl disable . (reload) . . --now . 219. poweroff NAME... . systemd-vmspawn(1) ACPI QMP . SIGRTMIN+4 init init systemd . init systemd(1) ( sysvinit) . stop poweroff . terminate ( ) . 212. reboot NAME... () . systemd-vmspawn(1) QMP . SIGINT init Ctrl+Alt+Del . restart reboot . 209. pause NAME... () . systemd-vmspawn(1) vCPU -- ACPI . resume . 261. resume NAME... . pause . 261. terminate NAME... . (kill ) . poweroff . 206. kill NAME... . . --kill-whom= . --signal= . 206. bind NAME PATH [PATH] (bind mount) . . . --read-only . --mkdir . systemd- nspawn(1) (--private-users) . (device nodes) AF_UNIX FIFO . 219. bind-volume NAME SPEC storagectl(1) . SPEC "PROVIDER:VOLUME[:CONFIG][:K=V,...]" --bind-volume= systemd-vmspawn(1) . "PROVIDER:VOLUME" unbind-volume . systemd-vmspawn io.systemd.MachineInstance . 261. unbind-volume NAME STORAGE-NAME . STORAGE-NAME "PROVIDER:VOLUME" bind-volume . ( --bind-volume= systemd- vmspawn(1)) io.systemd.MachineInstance.StorageImmutable . 261. copy-to NAME PATH [PATH] --force . . . (UID/GID 0) . 219. copy-from NAME PATH [PATH] --force . . . (UID/GID 0) . 219. (Image Commands) list-images . /var/lib/machines/ ( ) . start ( ) . (".") . --all . ".host" . 219. image-status [NAME...] . . show-image ( ) . 219. show-image [NAME...] . . NAME . . --all . --property= . . image-status . 219. edit NAME|FILE . systemd.nspawn(5) . edit /etc/systemd/nspawn/ . 254. cat NAME|FILE . 254. clone NAME NAME ( ) . . btrfs . (copy-on-write) . (machine ID) . . --read-only . 219. rename NAME NAME . . 219. read-only NAME [BOOL] ( ) . . (true) . 219. remove NAME... . ".host" . 219. set-limit [NAME] BYTES ( disk quota). . . . . K M G T . "-" . btrfs . 220. clean ( ). /var/lib/machines/ . machinectl list-images --all . --all . /var/lib/machines/ . importctl pull-tar importctl pull-raw . machinectl clean . 230. (OPTIONS) : -p, --property= . . "Name". . 206. --value show "=" . 230. -P --value --property= "=" . -P -p/--property= . 256. -a, --all . (".") . . 206. -l, --full . --max-addresses=full . 206. --kill-whom= kill . leader supervisor all (leader) (supervisor) . all . 206. -s, --signal= kill . SIGTERM SIGINT SIGSTOP . SIGTERM . "help" "list" . --uid= shell (UID) . shell . "root" . login ( ) . 225. -E NAME[=VALUE], --setenv=NAME[=VALUE] shell . . "=" VALUE . login . 230. --mkdir bind . FIFO . 219. --read-only bind . clone . 219. -n, --lines= status . . 10 . 219. -o, --output= status . journalctl(1) . "short" . 219. --runner=nspawn|vmspawn systemd- nspawn(1) systemd-vmspawn(1) . systemd- nspawn(1) . 256. -V -V --runner=vmspawn . 256. --now enable disable . start poweroff enable disable . 253. --force . 219. --max-addresses= list-machines IP . 1 . "all" . 0 . "..." . 232. -q, --quiet . 236. -H, --host= . "@" . ssh ( ":") ( "/") . SSH . machinectl -H HOST . IPv6 . -M, --machine= systemd-machined.service(8) . 235. --no-pager (pager) . --no-legend (legend) . --no-ask-password . -h, --help . --version . (MACHINE AND IMAGE NAMES) machinectl . DNS / . . . . - . 64 . ".host" . . machinectl list --all . UTF-8 ( ) . . ".host" . ".host" . machinectl list-images --all . (FILES AND DIRECTORIES) /var/lib/machines/ /usr/local/lib/machines/ /usr/lib/machines/ . /var/lib/container/ . /usr/ . (symlink) /var/lib/machines/ machinectl . btrfs ( ) . systemd-nspawn(1) machinectl : o . o ( btrfs) . . o ("Raw") GPT MBR. ".raw" . --directory= --image= systemd-nspawn(1) . (EXAMPLES) 1. RAW # importctl pull-raw -mN \ https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64-disk-kvm.img \ jammy # systemd-firstboot --image=/var/lib/machines/jammy.raw --prompt-root-password --force # machinectl start jammy # machinectl login jammy .raw "jammy" . systemd-firstboot(1) . . . (EXIT STATUS) 0 . (ENVIRONMENT) $SYSTEMD_LOG_LEVEL ( ). . ( ) : emerg alert crit err warning notice info debug 0...7 . syslog(3) . console syslog kmsg journal ( SYSTEMD_LOG_LEVEL=debug,console:info info ) . . $SYSTEMD_LOG_COLOR . (true) tty . journalctl(1) . $SYSTEMD_LOG_TIME . . journalctl(1) . $SYSTEMD_LOG_LOCATION . . . . $SYSTEMD_LOG_TID . (TID) . . . $SYSTEMD_LOG_TARGET . console ( tty ) console-prefixed ( tty "facility" syslog(3) ) kmsg ( ) journal ( ) journal-or-kmsg ( kmsg) auto ( ) null ( ). $SYSTEMD_LOG_RATELIMIT_KMSG kmsg (ratelimit) . . "true" . systemd kmsg . $SYSTEMD_PAGER, $PAGER --no-pager . $SYSTEMD_PAGER $PAGER . $SYSTEMD_PAGER $PAGER less(1) more(1) . . "cat" --no-pager . : $SYSTEMD_PAGERSECURE $SYSTEMD_PAGER $PAGER ( "cat" "") . $SYSTEMD_LESS less ( "FRSXMK"). : K Ctrl+C . less Ctrl+C . $SYSTEMD_LESS "K" less Ctrl+C . X termcap . . . $LESS less systemd . less(1) . $SYSTEMD_LESSCHARSET less ( "utf-8" UTF-8 ). $LESSCHARSET less systemd . $SYSTEMD_PAGERSECURE less(1) <<>> . sudo(8) pkexec(1) . . << >> (secure mode) ( ). << >> --no-pager PAGER=cat . . " " . " " LESSSECURE=1 . less(1) " " . . SYSTEMD_PAGERSECURE=0 . $SYSTEMD_PAGERSECURE systemd " " . UID ( geteuid(2) sd_pid_get_owner_uid(3) ) sudo(8) ($SUDO_UID [1]) " " . SYSTEMD_PAGERSECURE=1 " " . . $SYSTEMD_PAGERSECURE . $SYSTEMD_PAGER $PAGER $SYSTEMD_PAGERSECURE . $SYSTEMD_COLORS . () systemd . $COLORTERM "truecolor" "24bit" 24 256 $NO_COLOR $TERM . true $NO_COLOR . false ( ) . "16", "256", "24bit" 16 ANSI 256 24 . "auto-16", "auto-256", "auto-24bit" $TERM . $SYSTEMD_URLIFY . . systemd $TERM . (SEE ALSO) systemd(1), systemd-machined.service(8), systemd-nspawn(1), systemd.special(7), importctl(1), tar(1), xz(1), gzip(1), bzip2(1), zstd(1) (NOTES) 1. $SUDO_UID . systemd 261.2 MACHINECTL(1)