lxc-wait(1)

📦
version 7.0.0 · 17 versions
, in alpine 3.24

💖 lxc-wait(1) — wait for a specific container state 💖

🌸 NAME 🌸

lxc-wait — wait for a specific container state. 🎀

✨ SYNOPSIS ✨

lxc-wait {-n name} {-s states}

🦋 DESCRIPTION 🦋

okay so lxc-wait literally waits for a specific container state before it exits — and bestie, that is highkey useful for scripting. It’s giving “hold the group chat until the vibe check passes” energy, no cap. 💅✨

🎀 OPTIONS 🎀

  • -s, --state states — specify the container state(s) to wait for. The container states can be ORed to specify several states. 🌈
  • -t, --timeout timeout — wait timeout seconds for the desired state to be reached. ⏳

💅 COMMON OPTIONS 💅

These options are common to most of lxc commands — iykyk. 💖

  • -?, -h, --help — print a longer usage message than normal. 🙋
  • --usage — give the usage message. 📜
  • -q, --quiet — mute on. 🫢
  • -P, --lxcpath=PATH — use an alternate container path. The default is /var/lib/lxc. 📁
  • -o, --logfile=FILE — output to an alternate log FILE. The default is no log. 📝
  • -l, --logpriority=LEVEL — set log priority to LEVEL. The default log priority is ERROR. Possible values are: FATAL, ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE. 🔥 Note that this option is setting the priority of the events log in the alternate log file. It does not affect the ERROR events log on stderr. ⚠️
  • -n, --name=NAME — use container identifier NAME. The container identifier format is an alphanumeric string. 🏷️
  • --rcfile=FILE — specify the configuration file to configure the virtualization and isolation functionalities for the container. 🧚 This configuration file, if present, will be used even if there is already a configuration file present in the previously created container (via lxc-create). 💖
  • --version — show the version number. 👑

🍓 EXAMPLES 🍓

lxc-wait -n foo -s RUNNING

exits when 'RUNNING' is reached. ✅

lxc-wait -n foo -s 'RUNNING|STOPPED'

exits when 'RUNNING' or 'STOPPED' state is reached. ✅

💀 DIAGNOSTIC 💀

  • The container was not found — the specified container was not created before with the lxc-create command. 🫠

🦋 SEE ALSO 🦋

Signing off from the lxc-wait(1) manual page, dated 2026-05-01. 💅✨

📦 where this page comes from