Skip to main content

Quick Install (Linux/macOS)

The fastest way to install:
curl -sSL https://certwatch.app/install.sh | bash
This script:
  • Detects your OS and architecture
  • Downloads the latest release from GitHub
  • Installs to /usr/local/bin/cw-agent
  • Verifies the installation
You can also specify a custom install directory: INSTALL_DIR=/custom/path curl -sSL https://certwatch.app/install.sh | bash

Package Managers

Homebrew (macOS/Linux)

brew install certwatch-app/tap/cw-agent

Go Install

go install github.com/certwatch-app/cw-agent/cmd/cw-agent@latest
Requires Go 1.21 or later.

Docker

docker pull ghcr.io/certwatch-app/cw-agent:latest
See the Docker deployment guide for complete instructions.

Manual Download

Download pre-built binaries from the GitHub Releases page.
PlatformArchitectureDownload
Linuxx86_64 (amd64)cw-agent_X.X.X_linux_amd64.tar.gz
LinuxARM64cw-agent_X.X.X_linux_arm64.tar.gz
macOSx86_64 (Intel)cw-agent_X.X.X_darwin_amd64.tar.gz
macOSARM64 (Apple Silicon)cw-agent_X.X.X_darwin_arm64.tar.gz
Windowsx86_64cw-agent_X.X.X_windows_amd64.zip

Manual Installation Steps

1

Download

curl -LO https://github.com/certwatch-app/cw-agent/releases/latest/download/cw-agent_X.X.X_linux_amd64.tar.gz
2

Extract

tar -xzf cw-agent_X.X.X_linux_amd64.tar.gz
3

Install

sudo mv cw-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/cw-agent
4

Verify

cw-agent version

Verify Installation

After installation, verify the agent is working:
cw-agent version
Expected output:
CertWatch Agent v0.2.1

  Version     v0.2.1
  Commit      abc1234
  Build Date  2025-01-01
  Go Version  go1.22.0
  Platform    linux/amd64

Next Steps