Installation

kiln is distributed as a single binary with no external dependencies. Choose your preferred installation method below.

Binary Releases

Download pre-built binaries for your platform from the releases page.

Linux

AMD64

# Download and extract the latest release
curl -L https://github.com/Thunderbottom/kiln/releases/download/v1.0.3/kiln_1.0.3_linux_amd64.tar.gz
tar xzf kiln_1.0.3_linux_amd64.tar.gz

# Install to system PATH
chmod +x kiln
sudo mv kiln /usr/local/bin/

# Verify installation
kiln --version

ARM64

# Download and extract the latest release
curl -L https://github.com/Thunderbottom/kiln/releases/download/v1.0.3/kiln_1.0.3_linux_arm64.tar.gz
tar xzf kiln_1.0.3_linux_arm64.tar.gz

# Install to system PATH
chmod +x kiln
sudo mv kiln /usr/local/bin/

# Verify installation
kiln --version

macOS

Apple Silicon (M1/M2/M3)

# Download and extract the latest release
curl -L https://github.com/Thunderbottom/kiln/releases/download/v1.0.3/kiln_1.0.3_darwin_arm64.tar.gz
tar xzf kiln_1.0.3_darwin_arm64.tar.gz

# Install to system PATH
chmod +x kiln
sudo mv kiln /usr/local/bin/

# Verify installation
kiln --version

Intel

# Download and extract the latest release
curl -L https://github.com/Thunderbottom/kiln/releases/download/v1.0.3/kiln_1.0.3_darwin_amd64.tar.gz
tar xzf kiln_1.0.3_darwin_amd64.tar.gz

# Install to system PATH
chmod +x kiln
sudo mv kiln /usr/local/bin/

# Verify installation
kiln --version

Windows

1. Download the latest release: kiln_1.0.3_windows_amd64.tar.gz
2. Extract kiln.exe using Windows Explorer or 7-Zip
3. Place it in a directory in your PATH (e.g., C:\Program Files\kiln\)
4. Open Command Prompt or PowerShell and run kiln --version

Add to PATH:

• Windows 10/11: Settings → System → About → Advanced system settings
• Click "Environment Variables" → Edit PATH variable
• Add the directory containing kiln.exe

Install from Source

If you have Go 1.23 or later installed:

go install github.com/thunderbottom/kiln@latest

This installs the latest release to your $GOPATH/bin directory.

Package Managers

Package manager support:

Nix

nix run github:thunderbottom/kiln

Arch (Coming Soon)

yay -S kiln

Homebrew (Coming Soon)

brew install thunderbottom/tap/kiln

Development Build

To build from the development branch:

git clone https://github.com/thunderbottom/kiln.git
cd kiln
go mod download
make build

# Binary will be available at ./bin/kiln

Verification

After installation, verify kiln is working:

# Check version
kiln --version

# View help
kiln --help

# Test key generation
kiln init key --help

---

Next Steps

Ready to get started? Initialize your first kiln project:

Quick Start Guide Learn Core Concepts