Skip to main content
View logs for a running instance. Opens an interactive terminal UI by default, or use flags for non-interactive modes. For local instances, Docker or Podman must be running. For cloud instances, you must be authenticated via helix auth login.

​
Usage

helix logs [INSTANCE] [OPTIONS]

​
Arguments

ArgumentDescription
INSTANCEThe instance to view logs for. If omitted, an interactive selection prompt will appear

​
Available flags

FlagTypeDescription
--live, -lBooleanStream live logs non-interactively to stdout. Press Ctrl+C to stop
--range, -rBooleanQuery historical logs within a time range. Requires --start and/or --end
--startStringStart time for range query (ISO 8601, e.g. 2024-01-15T10:00:00Z). Defaults to 15 minutes before end time
--endStringEnd time for range query (ISO 8601, e.g. 2024-01-15T11:00:00Z). Defaults to now
Maximum range duration is 1 hour. Start time must be before end time.

​
Interactive TUI mode

When run without flags, helix logs opens an interactive terminal UI with vim-style navigation: Navigation:
KeyAction
Down ArrowScroll down one line
Up ArrowScroll up one line
jScroll down one page
kScroll up one page
ztJump to top of logs
zbJump to bottom of logs
Mode switching:
KeyAction
lSwitch to live streaming mode
rSwitch to range mode (select time presets or custom range)
EscQuit
Range mode presets:
  • Last 15 minutes
  • Last 30 minutes
  • Last hour
  • Custom range (date/time picker)

​
Examples

# Open interactive log viewer (will prompt for instance selection)
helix logs

# Open interactive log viewer for a specific instance
helix logs my-instance

# Stream live logs non-interactively
helix logs my-instance --live

# Query logs from a specific time range
helix logs my-instance --range --start 2024-01-15T10:00:00Z --end 2024-01-15T11:00:00Z

# Query last 15 minutes (end defaults to now)
helix logs my-instance --range --start 2024-01-15T10:45:00Z