Zabbix/zabbix-apk-builder

Zabbix APK Builder

Automated build system for creating Zabbix monitoring packages for Alpine Linux using Docker.

What it does

This project builds separate Alpine Linux packages for:

• zabbix-agent - Monitoring agent for data collection
• zabbix-proxy - Network monitoring proxy daemon
• zabbix - Meta-package that installs both components

Each package includes proper OpenRC init scripts and user management for production deployment.

Quick Start

# Build packages
./build.sh

# Install on Alpine Linux
apk add --allow-untrusted packages/zabbix-agent-*.apk
apk add --allow-untrusted packages/zabbix-proxy-*.apk

# Enable and start services
rc-update add zabbix-agent default
rc-service zabbix-agent start

Configuration

Change Zabbix Version

Edit APKBUILD:

pkgver=7.4.2  # Change to desired version

Change Architecture

Edit APKBUILD:

arch="all"           # All architectures
arch="x86_64"        # 64-bit Intel/AMD only
arch="x86_64 aarch64"  # 64-bit Intel/AMD and ARM64

Update Checksums

After changing the version:

# Manual approach
wget https://cdn.zabbix.com/zabbix/sources/stable/X.Y/zabbix-X.Y.Z.tar.gz
sha512sum zabbix-X.Y.Z.tar.gz  # Update sha512sums in APKBUILD
# Or let the build system handle it
./build.sh  # Will download and verify against official SHA256

sha512 is used per Alpine recommendation: https://wiki.alpinelinux.org/wiki/APKBUILD_Reference New packages should use only sha512sums. Support for md5sums and sha1sums was dropped.

Build Process

1. Docker Build: Creates Alpine Linux build environment
2. Download Sources: abuild checksum downloads tarball and generates SHA512
3. Package Build: Compiles and packages using Alpine's abuild system
4. Output: Generated APK files in packages/ directory

Requirements

• Docker
• Internet connection (for source download and verification)

Files

• APKBUILD - Alpine package definition
• build.sh - Build automation script
• Dockerfile - Build environment container
• zabbix-agent.* - Agent service configuration files
• zabbix-proxy.* - Proxy service configuration files