lift stack
Install multi-tool stacks from the OneLift registry with sequential tool installation, variable overrides, and domain configuration.
lift stack
Install multi-tool stacks from the OneLift registry. A stack is a curated bundle of tools that are installed sequentially in the correct order with pre-configured connections between them.
Subcommands
lift stack install
Install a stack on the server. Tools are installed one by one in the order defined by the stack. Each tool's variables are resolved independently, and tools can reference previously installed tools via linked variables.
| Flag | Description | Default |
|---|---|---|
--var KEY=VALUE | Override a variable for all tools. Can be repeated | - |
--domain <domain> | Domain name passed to all tools (sets APP_DOMAIN) | - |
--skip-optional | Skip optional tools in the stack | false |
--continue-on-error | Continue installing remaining tools if one fails | false |
# Install the monitoring stack
lift stack install monitoring
# Install with a domain for Traefik routing
lift stack install webdev --domain app.example.com
# Skip optional tools
lift stack install monitoring --skip-optional
# Continue even if a tool fails
lift stack install monitoring --continue-on-error
How It Works
- The stack definition is fetched from the registry, including all tool manifests
- Each tool manifest is converted from registry format to CLI format
- Tools are installed sequentially in the defined order
- After each tool installs, its state is saved and made available to subsequent tools via linked variables
- Stack-level
after_<toolname>hooks run after each tool (e.g., configuring Grafana datasources after Grafana installs)
Paid Stacks
Some stacks require a paid license. The requiredTier field on a stack determines the minimum plan needed:
| Tier | Access |
|---|---|
free | No license required |
pro | Requires Pro license |
enterprise | Requires Enterprise license |
If you attempt to install a paid stack without a valid license, you'll be prompted to set one with lift license set <key>.
Available Stacks
Use lift catalog to see all available stacks, or lift catalog info <stack> for details:
# List all stacks
lift catalog
# See stack details and tool list
lift catalog info monitoring
Related
- lift catalog - Browse available tools and stacks
- lift install - Install a single tool
- lift license - Manage license for paid stacks
- lift uninstall - Remove an installed tool