Getting Started

Installation

Install the TLD CLI on Linux, macOS, or Windows (WSL2).

Prerequisites

Tool	Minimum Version	Notes
Docker	24.0+	Required to run labs
Node.js	18+	Required for npm install method only
Go	1.21+	Required for build-from-source only
macOS / Linux	any	Windows requires WSL2

Docker is required

TLD labs run inside Docker containers. Make sure Docker is installed and the daemon is running before you start a lab. Run `docker info` to verify.

The easiest way to install TLD is via npm. This works on Linux, macOS, and Windows (WSL2).

bash

$ npm install -g @tld/cli

macOS and Linux users can install via Homebrew.

bash

$ brew tap thelastdeploy/tap

$ brew install tld

Clone the repository and build the CLI from source. This requires Go 1.21+.

bash

$ git clone https://github.com/thelastdeploy/thelastdeploy.git

$ cd thelastdeploy

# Build and install to /usr/local/bin

$ make install

# Or build to ./bin/tld without installing

$ make build

bash

$ tld version

# tld v0.1.0 (linux/amd64)

$ tld doctor

# Checking environment...

# ✓ Docker is running (24.0.5)

# ✓ Docker socket accessible

# ✓ Disk space OK (45GB free)

# ✓ Network connectivity OK

# All checks passed.

Something not working?

Check the Troubleshooting page for common installation issues — Docker not running, permission denied, or port conflicts.