Installation

Installation

Prerequisites

• Go 1.22+ - Required for building from source
• DNS Provider Account - Active account with API access enabled
• Public IP - Whitelisted for API access (provider-specific requirement)

See the Configuration Guide for API credential setup.

Installation Methods

Build from Source (Recommended)

# Clone repository
git clone https://github.com/SamyRai/zonekit.git
cd zonekit

# Build
make build

# Optional: Install to system
make install  # Installs to $GOPATH/bin or $GOBIN

Download Pre-built Binaries

1. Download the latest release: github.com/SamyRai/zonekit/releases

2. Extract for your platform:

   • zonekit-linux-amd64 - Linux
   • zonekit-darwin-amd64 - macOS Intel
   • zonekit-darwin-arm64 - macOS Apple Silicon
   • zonekit-windows-amd64.exe - Windows

3. Add to PATH:

   # Linux/macOS
   chmod +x zonekit
   sudo mv zonekit /usr/local/bin/
   
   # Windows: Add directory to PATH environment variable

Verify Installation

zonekit --version
# Expected: zonekit version 0.1.0

Development Setup

For contributors:

make dev-setup  # Install development tools
make test       # Run tests
make lint       # Run linter

See the Contributing Guide for complete development instructions.