Skip to main content
Deploy the Lager box software, Docker container, and supporting tools onto a new or existing box.

Syntax

Options

Either --box or --ip is required. If both are provided, the command exits with an error.

What Gets Installed

Installation Flow

  1. Resolve target - Looks up box IP from --box name or uses --ip directly
  2. Verify SSH - Tests key-based authentication, falls back to password if needed
  3. Show summary - Displays what will be installed and asks for confirmation
  4. Deploy - Runs the deployment script (up to 30 minutes for a fresh install)
  5. Store version - Writes the CLI version to /etc/lager/version on the box
  6. Add to config - Optionally adds the box to your local .lager config

Examples

SSH Authentication

The command attempts key-based SSH authentication first. If that fails, it offers to continue with password authentication. For new hosts, the SSH host key is accepted automatically. If the host key has changed since a previous connection, the command asks you to verify the change manually before proceeding.

Notes

  • Requires SSH client tools (ssh, ssh-keygen) to be installed locally
  • The deployment script is bundled with the lager-cli package
  • After installation, verify connectivity with lager hello --box <name>
  • Use lager update to deploy code updates to an already-installed box
  • Use lager uninstall to remove Lager software from a box