Skip to main content
The Lager CLI (lager) enables direct control of your hardware from the command line and text editor. 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.
  • And more!

​
Prerequisites

  • A Lager Box
  • Python 3.10 or higher
  • pip3 package manager

​
Step 1: Install the CLI Package

To install the Lager CLI, make sure you’ve fulfilled the above prerequisites and run the following command. 
pip3 install -U lager-cli
You can check your version to make sure it’s installed: 
lager --version

​
Step 2: Add Your Lager Box

To interact with a Lager Box, you’ll need its local IP or IP from your VPN. Once you have that, you can add it to your list of Lager Boxes and give it a name! 
lager boxes add --name my-lager-box --ip 100.123.456.78
You can add all of the Lager Boxes included in your plan using the command below and view your list of them using the following command. 
lager boxes
Note that this list is unique to your personal computer which means you can give your Lager Boxes any name you want (though it is normally in your best interest to agree on a naming convention with your team).

​
Step 3: Verify Connectivity

Now that you’ve added a Lager Box, test that you can communicate with your Lager Box: 
lager hello --box my-lager-box
If your Lager Box says hello back, then you are ready to start using it!