Skip to main content
Monitor connectivity, response times, and net configuration for one or all Lager Boxes.

​
Syntax

lager status [OPTIONS] [COMMAND]

​
Global Options

OptionDescription
--box TEXTLagerbox name or IP address
--helpShow help message and exit

​
Commands

CommandDescription
tuiLaunch interactive status monitoring TUI

​
Usage Modes

​
All Boxes Overview

When invoked without --box, displays a summary table of all configured boxes: 
lager status
Output columns:
ColumnDescription
Box NameName of the configured box
StatusOnline, Offline, or Error
Response (ms)Ping or HTTP response time
IP AddressBox IP address
NetsNumber of configured nets
Last ErrorMost recent error message
Online boxes are shown in green, offline boxes in red.

​
Single Box Details

When invoked with --box, displays detailed information for a specific box including all configured nets: 
lager status --box my-lager-box
Output includes:
  • Box name, IP address, and connectivity status
  • Response time (if online)
  • Table of all configured nets with name, type, instrument, channel, and address

​
Command Reference

​
tui

Launch an interactive terminal UI for real-time box monitoring. 
lager status tui [OPTIONS]
Options:
OptionTypeDefaultDescription
--refresh-intervalfloat10.0Auto-refresh interval in seconds
TUI Layout:
  • Left panel - All-boxes overview table with status, lock state, response time, and net count
  • Right panel - Tabbed detail view for the selected box:
    • Usage History - Session timestamps, users, actions, and durations
    • Nets - Net name, type, instrument, channel, and status
    • Activity Log - Timestamped system events
  • Summary bar - Online/total boxes, total nets, auto-refresh status, last update time
Keyboard Shortcuts:
KeyAction
qQuit
rManual refresh
aToggle auto-refresh
TabNext detail tab
Shift+TabPrevious detail tab
Up/DownNavigate table rows

​
Connectivity Checking

For IP addresses, lager status sends ICMP pings. For box IDs, it makes an HTTP health check. Error types are distinguished:
Error TypeMeaning
timeoutHost not responding
no_routeVPN or network connectivity issue
connection_refusedService not running on box
dns_errorDNS resolution failure
unreachableNetwork unreachable

​
Examples

# Overview of all boxes
lager status

# Detailed status for one box
lager status --box my-lager-box

# Launch monitoring TUI with 5-second refresh
lager status tui --refresh-interval 5.0

​
Notes

  • Net information is loaded from local configuration, so nets are shown even if the box is offline
  • The TUI requires a terminal that supports ANSI escape codes
  • If --box refers to a name not found in .lager, the command checks if it is a valid IP address
  • Use lager boxes add --name <NAME> --ip <IP> to register a new box before checking status