Skip to content

kuke log

Print a container's stdout/stderr stream.

kuke log  <cell> [flags]
kuke logs <cell> [flags]      # alias

<cell> is a positional argument. --realm, --space, and --stack all default to default, so for a cell in the default location you only need the cell name.

By default, kuke log prints the current contents of the capture file and exits. Pass -f/--follow to tail until SIGINT.

Flags

Flag Default Description
--container (auto-pick) Container within the cell to read (omit to auto-pick the only non-root container)
--realm default Realm that owns the cell
--space default Space that owns the cell
--stack default Stack that owns the cell
--follow, -f false Tail the file until SIGINT instead of printing current contents and exiting

Plus all global flags.

Behavior

kuke log reads the on-disk capture file maintained by the daemon for each container's stdout/stderr. Without -f, it prints what's there and exits — useful for scripting and for checking on a container that has already terminated. With -f, it tails the file until you SIGINT (Ctrl-C) the command.

Container selection: if the cell has exactly one non-root container, --container can be omitted. Otherwise, pass --container explicitly.

Examples

# Print and exit (cell in default/default/default)
sudo kuke log web

# Follow until Ctrl-C
sudo kuke log web -f

# Explicit container in a multi-container cell
sudo kuke log web --container nginx -f

# Non-default realm/space/stack
sudo kuke log wp --realm default --space blog --stack wordpress

kuke log vs. kuke daemon logs

kuke log is for any user-workload container. To read the kukeond daemon's own logs without typing out the static kuke-system / kukeon / kukeon / kukeond coordinates, use kuke daemon logs — it's a thin wrapper around kuke log with the realm/space/stack/cell pre-filled.

  • kuke daemon logs — shortcut for the daemon's own log stream
  • kuke attach — interactive sbsh terminal instead of a one-way log stream