Skip to main content
The Lager CLI (lager) enables direct control of your hardware from the command line. With this tool, you can:
  • Control power supplies: Programmatically set voltage and current for your DUT.
  • Flash firmware images: Update your device with new firmware builds.
  • Monitor hardware in real-time: Stream voltage, current, and other sensor data.
  • Manipulate I/O pins: Directly control GPIO for testing and automation.

​
Prerequisites

  • Python 3.10 or higher
  • pip3 package manager
  • A Lager Box on your network

​
Step 1: Install the CLI Package

pip3 install -U lager-cli
This installs the latest version and ensures it’s on your PATH. Check version: 
lager --version

​
Step 2: Add Your Lager Box

Add your Lager Box to the CLI configuration: 
lager boxes add --name my-lager-box --ip 100.91.127.26
Replace:
  • my-lager-box with a friendly name for your Lager Box
  • 100.91.127.26 with your Lager Box’s IP address (Tailscale or local network)

​
Step 3: Verify Connectivity

Test that you can communicate with your Lager Box: 
lager hello --box my-lager-box
You should see a response confirming the connection.

​
Managing Multiple Lager Boxes

List all configured Lager Boxes: 
lager boxes
Add additional Lager Boxes: 
lager boxes add --name lab-lager-box --ip 100.105.225.48
lager boxes add --name production-lager-box --ip 192.168.1.100
Remove a Lager Box: 
lager boxes delete --name old-lager-box

​
Setting Default Lager Box

Set a default Lager Box so you don’t need to specify --box every time: 
lager defaults add --box my-lager-box

​
SSH Key Setup (Required for Lager Box Access)

For commands that execute on the Lager Box, you need SSH key access: 
ssh-copy-id lagerdata@100.91.127.26
This enables passwordless SSH connections to the Lager Box.

​
Support

If any issues occur during install: