Hello

Validate CLI installation and Lager Box connection

Quick command to validate your CLI installation, Lager Box connection, and display the box version.

Syntax

lager hello [OPTIONS]

Options

Option	Description
--box TEXT	Lager Box name or IP address
--help	Show help message and exit

---

Usage

# Basic hello command
lager hello

# Hello with specific Lager Box
lager hello --box my-lager-box

# Hello with Lager Box IP
lager hello --box <BOX_IP>

---

Output

The hello command prints the box name, its IP address, the box version, and a success line:

$ lager hello --box my-lager-box

Box: my-lager-box
IP: 100.64.1.42
Version: 0.47.0 (release)

my-lager-box is online and responding!

(release) means that the box runs the release tag of the version that it reports. For any other ref, the brackets show that ref and its commit, as <ref>@<commit>. A box deployed from a branch or a commit adds -- not a release build:

Version: 0.47.0 (main@5d84c68612384eed2854638c1e0941a4ff8b7893 -- not a release build)

A box that predates the ref record shows only the version. If the box reports no version, the line reads Version: Unknown. If the box answers /hello with an error, the last line reads my-lager-box responded with HTTP <code>.

---

Examples

# Verify connectivity after initial setup
lager hello --box my-lager-box

# Quick check that default box is reachable
lager defaults add --box my-lager-box
lager hello

# Check version of a specific box
lager hello --box my-lager-box

---

Notes

• Simple validation command to test CLI installation
• Verifies connectivity to the Lager Box
• Reads the version and ref from the box API on port 9000 (/status), then checks /hello
• Useful for troubleshooting connection issues
• No arguments required when a default box is set
• Returns a success message when the connection works