Skip to content

Installation

This page covers supported install paths.

Install with the script

Install latest
curl -fsSL https://raw.githubusercontent.com/atbuy/carrier/main/install.sh | sh
Install a specific version
curl -fsSL https://raw.githubusercontent.com/atbuy/carrier/main/install.sh | sh -s -- --version v0.1.0
Install system-wide
curl -fsSL https://raw.githubusercontent.com/atbuy/carrier/main/install.sh | sh -s -- --system
Install latest
irm https://raw.githubusercontent.com/atbuy/carrier/main/install.ps1 | iex
Install a specific version
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/atbuy/carrier/main/install.ps1))) -Version v0.1.0"
Install system-wide
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/atbuy/carrier/main/install.ps1))) -System"

The installer detects your OS and CPU architecture, installs into your user bin directory, and prints carrier version when done. Use --system on Linux/macOS or -System on Windows for a system-wide install.

Default install locations

Linux/macOS installs to ~/.local/bin/carrier by default. Windows installs to %LOCALAPPDATA%\carrier\bin\carrier.exe and adds that directory to the user PATH.

Release notes include checksum verification details for users who want manual validation.

Install with Go

If you have Go installed:

Install latest Go module
go install github.com/atbuy/carrier/cmd/carrier@latest

Ensure Go's bin dir is on PATH:

Add GOPATH/bin to PATH
export PATH="$PATH:$(go env GOPATH)/bin"

Verify:

Verify install
carrier version
carrier doctor

Build from source

Build local binary
git clone https://github.com/atbuy/carrier.git
cd carrier
make build
./bin/carrier version

Install from checkout:

make install
Alias
alias c='carrier'

Add it to:

  • ~/.zshrc for zsh
  • ~/.bashrc for bash

Optional desktop notifications

Notifications are requested per command, not enabled globally. Carrier uses the platform notification tool:

Platform Tool
Linux notify-send
macOS osascript
Windows PowerShell notification balloon

Check availability:

Check local setup
carrier doctor

Use notifications:

Request notifications
carrier -n run docker compose build
carrier -N run ls

-n respects notify.min_duration; -N bypasses that duration gate.