# Install labctl with Homebrew, Nix

CLI tool for interacting with iximiuz labs and playgrounds. Version 0.1.97 via Homebrew; verified 2026-07-06.

## Install

```sh
sudo av install brew:labctl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install labctl
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#labctl
```

  Evidence: nixpkgs package indexes: pkgs/by-name/la/labctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:labctl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/labctl>
- **Version:** 0.1.97
- **Source summary:** CLI tool for interacting with iximiuz labs and playgrounds
- **Homepage:** <https://labs.iximiuz.com/playgrounds>
- **Repository:** <https://github.com/iximiuz/labctl>
- **Upstream docs:** <https://github.com/iximiuz/labctl#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/iximiuz/labctl/archive/refs/tags/v0.1.97.tar.gz>
- **Last updated:** 2026-07-06T10:07:37Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- labctl (cli)
- labctl (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.1.97
- Package-manager updated: 2026-07-06
- Local data: ok
- Upstream repository: https://github.com/iximiuz/labctl
- Upstream latest detected: v0.1.97 (current)
## Project history and usage

labctl is the command-line client for iximiuz Labs, a hands-on learning platform for Linux, containers, Kubernetes, networking, and DevOps playgrounds. It starts, lists, stops, destroys, and connects to remote playground environments from a local terminal.

Its history is tightly coupled to iximiuz Labs rather than to a broad standalone ecosystem, so the package history is best understood as the CLI surface of a hosted microVM playground service.

### Project history

The labctl repository documents the tool as a way to start remote microVM playgrounds from the command line. The README lists Linux, Docker, Kubernetes, networking, and other DevOps playground types and describes those environments as ephemeral and disposable.

As the iximiuz Labs playground model evolved, labctl accumulated commands for browser opening, SSH access, IDE integration, public web terminals, HTTP exposure, port forwarding, and lifecycle management.

### Adoption history

Adoption is mostly iximiuz Labs users who prefer terminal access over a browser-only workflow. The README documents both the iximiuz install script and Homebrew installation on macOS and Linux, putting labctl into ordinary package-manager workflows despite its service-specific nature.

The public release page shows frequent 0.1.x releases, including additions for playground status, wait behavior, regions, IDE integration, and readiness handling.

### How it is used

A typical workflow is `labctl auth login`, followed by `labctl playground start docker`, `labctl playground start k3s --open`, or `labctl ssh <playground-id>`. The CLI can also expose shell sessions, forward ports, open local IDEs, and destroy playgrounds when finished.

Credentials and SSH material are stored under the iximiuz labctl configuration and SSH paths documented in the package curation, which makes the Homebrew package both a CLI and a local session manager for remote training machines.

### Why package nerds care

labctl is a useful example of a modern package-manager CLI whose main value is not local computation but authenticated orchestration of disposable remote environments. It turns a hosted learning product into scriptable terminal infrastructure.

For DevOps learners and authors, that means reproducible playgrounds can be launched, connected to, exposed, and torn down with commands rather than browser clicks.

### Timeline

- 2020s: iximiuz Labs popularized hands-on Linux, container, Kubernetes, and networking playgrounds.
- 2020s: labctl became the command-line access layer for starting and connecting to those playgrounds.
- 2025: The Playgrounds 2.0 write-up described labctl as an SSH access path for microVM-based playgrounds.
- 2026: v0.1.x releases added region, readiness, IDE, and playground lifecycle improvements.

### Related projects

- iximiuz Labs playgrounds are the hosted service labctl controls.
- Firecracker is relevant to the platform architecture because iximiuz Labs describes its playground machines as microVMs.
- VS Code Remote SSH, Cursor, Windsurf, and SSH tooling are adjacent user-facing integrations documented by labctl.

### Sources

- <https://github.com/iximiuz/labctl>
- <https://github.com/iximiuz/labctl/releases>
- <https://labs.iximiuz.com/playgrounds>
- <https://newsletter.iximiuz.com/posts/iximiuz-labs-playgrounds-2-0-dive-in>
- <https://raw.githubusercontent.com/iximiuz/labctl/main/README.md>


## Security Notes

No matching local secret-handling manifest was found for labctl. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.iximiuz/labctl/config.yaml

## Credential files

- Unix: ~/.iximiuz/labctl/config.yaml, ~/.ssh/iximiuz_labs_user
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** labctl
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - labctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/la/labctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [juju](https://www.automicvault.com/pkg/brew/juju/) - Shares av.db curated category or tags: cli, cloud-infrastructure, devops, kubernetes.
- [devspace](https://www.automicvault.com/pkg/brew/devspace/) - Shares av.db curated category or tags: cli, cloud-infrastructure, devops, docker, kubernetes.
- [colima](https://www.automicvault.com/pkg/brew/colima/) - Shares av.db curated category or tags: cli, cloud-infrastructure, docker, kubernetes.
- [container-canary](https://www.automicvault.com/pkg/brew/container-canary/) - Shares av.db curated category or tags: cli, cloud-infrastructure, docker, kubernetes.
- [dcp](https://www.automicvault.com/pkg/brew/dcp/) - Shares av.db curated category or tags: cli, cloud-infrastructure, docker, kubernetes.
- [havener](https://www.automicvault.com/pkg/brew/havener/) - Shares av.db curated category or tags: cli, cloud-infrastructure, devops, kubernetes.
- [helm](https://www.automicvault.com/pkg/brew/helm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, devops, kubernetes.
- [helmfile](https://www.automicvault.com/pkg/brew/helmfile/) - Shares av.db curated category or tags: cli, cloud-infrastructure, devops, kubernetes.

## Combined YAML source

View the package source record on GitHub. [combined/labctl.yml](https://github.com/automic-vault/db/blob/main/combined/labctl.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
