VERSION:(8)

📦
version 0.3.1 · 2 versions
  • 0.3.1 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 0.3.1 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

lxctl — utility to manage Linux Containers (LXC) 🫶

okay so bestie, this is the manual page for lxctl, from the VERSION:(8) section of the System Administration Utilities — and yes it manages Linux Containers, no cap 💅

🎀 DESCRIPTION 🎀

💜 Usage

lxctl [action] [vmname] [options]

that's the whole vibe: you pick an action, you point it at a vmname, and then you sprinkle on some options. iconic behavior honestly 🌸

🌈 OPTIONS 🌈

  • --help — prints a brief help message and exits 🫶 (short, sweet, slays)
  • --man — prints the manual page and exits 📖 (it's giving "read the docs, bestie")

🍓 start

Starts the container specified in the 1st argument 🚀

Required arguments

  • vmname — name of the container

🦋 stop

Stops the container specified in the 1st argument 🛑

Required arguments

  • vmname — name of the container

👑 create

Creates a container ✨ (fresh out the box, main character energy)

Required arguments

  • vmname — name of the container

Optional arguments

  • --ipaddr — IP address of the machine
  • --mask/netmask — network mask of the machine
  • --defgw — default gateway of the machine
  • --dns — primary DNS server
  • --ostemplate — template name, by default it is lucid_amd64
  • --config — path to configuration file, by default /etc/lxc/<container name> is used
  • --root — path to root file system, by default /var/lib/lxctl/<container name> is used
  • --addpkg — list of additional packages (comma-separated)
  • --pkgopt — list of additional packet manager options (space-separated, but as one argument)
  • --rootsz — size of logical volume for root FS, by default it is 10G
  • --hostname — sets the hostname of the machine, by default <container name> is used
  • --searchdomain — set a custom searchdomain in /etc/resolv.conf
  • --macaddr — set the custom mac address of the container
  • --autostart — autostart container each reboot host machine
  • --no-save — do not save yaml config for new container, by default $CONF_PATH/vmname.yaml is used
  • --load — create container from yaml config
  • --debug — show more information about install process
  • --tz — set custom timezone (Europe/Moscow, UTC, etc)
  • --empty — create a clear container for migrate here

💀 set

Changes container parameters 🔧 (glow-up mode)

Required arguments

  • vmname — name of the container

Optional arguments

  • --rootsz — increment of size of logical volume for root FS
  • --ipaddr — IP address of the machine
  • --mask/netmask — network mask of the machine
  • --defgw — default gateway of the machine
  • --dns — primary DNS server
  • --hostname — sets the hostname of the machine
  • --searchdomain — set a custom searchdomain in /etc/resolv.conf
  • --macaddr — set the custom mac address of the container
  • --userpasswd user:passwd — sets password for given user
  • --onboot {yes,no} — makes container [do not] start at boot
  • --tz — set custom timezone (Europe/Moscow, UTC, etc)
  • --cpu-shares — sets the CPU share of the container
  • --cpus — sets the CPU cores of the container
  • --mem — sets the memory share of the container (in bytes!)
  • --io — sets the IO share of the container

🧊 freeze

Freezes container 🥶

Required arguments

  • vmname — name of the container

unfreeze

Unfreezes container 🔥 (thaw her out)

Required arguments

  • vmname — name of the container

🌸 list

Lists all containers 📋

Optional arguments

  • --ipaddr — display with IP addr
  • --hostname — display with hostname.
  • --cgroup — display with cgroup
  • --mount — display with mount point for rootfs
  • --diskspace — display with free/full size
  • --all — display all information
  • --raw — display only vmnames

🚚 migrate

Migrate container from localhost to remote host.

Required arguments

  • --vmname — container name
  • --tohost — to which host we should migrate

Optional arguments

  • --remuser — remote username for ssh
  • --remport — remote port for ssh
  • --remname — remote container name
  • --onboot — start on boot? 1 or 0
  • --userpasswd — 'user:password' formatted password for user
  • --clone — cloning, a little bit faster and softer then simple migration
  • --rootsz — remote root fs size
  • --afterstart — start local container again after migration
  • --cpus — cpus allocated to container
  • --cpu-shares — cpu time share of the container
  • --mem — memory limit of the container
  • --io — IO throughput
  • --ipaddr — IP of the remote container
  • --searchdomain — DNS search domain of the container
  • --netmask — network mask
  • --defgw — default gateway
  • --dns — DNS server

🪄 vz2lxc

Migrate VZ-container from remote host to local LXC container.

Required arguments

  • --vmname — container name
  • --fromhost — from which host we should migrate
  • --remname — remote container name

Optional arguments

  • --remuser — remote username for ssh
  • --remport — remote port for ssh
  • --onboot — start on boot? 1 or 0
  • --rootsz — remote root fs size
  • --afterstart — start local container again after migration
  • --cpus — cpus allocated to container
  • --cpu-shares — cpu time share of the container
  • --mem — memory limit of the container
  • --io — IO throughput

💖 SEE ALSO 💖

The full documentation for Version: is maintained as a Texinfo manual. If the info and Version: programs are properly installed at your site, the command

info Version:

should give you access to the complete manual. 📚✨

and that's the whole page, bestie!! this lil cutie is Version: 0.3.0, dated June 2012, hanging out in section VERSION:(8) of the System Administration Utilities 🎀 go forth and container-ify, you got this 🫶💅

📦 where this page comes from