Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

Add Docker and package build support for agent

Juan Denis81c200fee2f9
diff --git a/.github/workflows/agent-release.yml b/.github/workflows/agent-release.yml
index 4c3a2e6f..6590087e 100644
--- a/.github/workflows/agent-release.yml
+++ b/.github/workflows/agent-release.yml
@@ -85,10 +85,212 @@ jobs:
path: dist/serverkit-agent-${{ steps.version.outputs.version }}-*
retention-days: 5
+ # Build .deb packages
+ build-deb:
+ name: Build DEB Package
+ runs-on: ubuntu-latest
+ needs: build
+
+ strategy:
+ matrix:
+ arch: [amd64, arm64]
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Get version
+ id: version
+ run: |
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+ VERSION="${{ github.event.inputs.version }}"
+ else
+ VERSION="${GITHUB_REF#refs/tags/agent-v}"
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+ - name: Download binary
+ uses: actions/download-artifact@v4
+ with:
+ name: serverkit-agent-linux-${{ matrix.arch }}
+ path: dist/
+
+ - name: Extract binary
+ run: |
+ cd dist
+ tar -xzf serverkit-agent-${{ steps.version.outputs.version }}-linux-${{ matrix.arch }}.tar.gz
+
+ - name: Build DEB package
+ run: |
+ chmod +x agent/packaging/deb/build.sh
+ cd agent/packaging/deb
+ ./build.sh "${{ steps.version.outputs.version }}" "${{ matrix.arch }}" "../../../dist/serverkit-agent-linux-${{ matrix.arch }}" "../../../packages"
+
+ - name: Upload DEB package
+ uses: actions/upload-artifact@v4
+ with:
+ name: serverkit-agent-deb-${{ matrix.arch }}
+ path: packages/*.deb
+ retention-days: 5
+
+ # Build .rpm packages
+ build-rpm:
+ name: Build RPM Package
+ runs-on: ubuntu-latest
+ needs: build
+
+ strategy:
+ matrix:
+ include:
+ - goarch: amd64
+ rpmarch: x86_64
+ - goarch: arm64
+ rpmarch: aarch64
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Get version
+ id: version
+ run: |
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+ VERSION="${{ github.event.inputs.version }}"
+ else
+ VERSION="${GITHUB_REF#refs/tags/agent-v}"
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+ - name: Install RPM build tools
+ run: |
+ sudo apt-get update
+ sudo apt-get install -y rpm
+
+ - name: Download binary
+ uses: actions/download-artifact@v4
+ with:
+ name: serverkit-agent-linux-${{ matrix.goarch }}
+ path: dist/
+
+ - name: Extract binary
+ run: |
+ cd dist
+ tar -xzf serverkit-agent-${{ steps.version.outputs.version }}-linux-${{ matrix.goarch }}.tar.gz
+
+ - name: Build RPM package
+ run: |
+ chmod +x agent/packaging/rpm/build.sh
+ cd agent/packaging/rpm
+ ./build.sh "${{ steps.version.outputs.version }}" "${{ matrix.rpmarch }}" "../../../dist/serverkit-agent-linux-${{ matrix.goarch }}" "../../../packages"
+
+ - name: Upload RPM package
+ uses: actions/upload-artifact@v4
+ with:
+ name: serverkit-agent-rpm-${{ matrix.rpmarch }}
+ path: packages/*.rpm
+ retention-days: 5
+
+ # Build Windows MSI
+ build-msi:
+ name: Build MSI Installer
+ runs-on: windows-latest
+ needs: build
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Get version
+ id: version
+ shell: bash
+ run: |
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+ VERSION="${{ github.event.inputs.version }}"
+ else
+ VERSION="${GITHUB_REF#refs/tags/agent-v}"
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+ - name: Install WiX Toolset
+ run: |
+ dotnet tool install --global wix
+
+ - name: Download binary
+ uses: actions/download-artifact@v4
+ with:
+ name: serverkit-agent-windows-amd64
+ path: dist/
+
+ - name: Extract binary
+ shell: bash
+ run: |
+ cd dist
+ unzip serverkit-agent-${{ steps.version.outputs.version }}-windows-amd64.zip
+
+ - name: Build MSI
+ shell: pwsh
+ run: |
+ cd agent/packaging/msi
+ .\build.ps1 -Version "${{ steps.version.outputs.version }}" -BinaryPath "..\..\..\dist\serverkit-agent-windows-amd64.exe" -OutputDir "..\..\..\packages"
+
+ - name: Upload MSI
+ uses: actions/upload-artifact@v4
+ with:
+ name: serverkit-agent-msi
+ path: packages/*.msi
+ retention-days: 5
+
+ # Build Docker image
+ build-docker:
+ name: Build Docker Image
+ runs-on: ubuntu-latest
+ needs: build
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Get version
+ id: version
+ run: |
+ if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+ VERSION="${{ github.event.inputs.version }}"
+ else
+ VERSION="${GITHUB_REF#refs/tags/agent-v}"
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+ - name: Set up QEMU
+ uses: docker/setup-qemu-action@v3
+
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@v3
+
+ - name: Login to Docker Hub
+ uses: docker/login-action@v3
+ with:
+ username: ${{ secrets.DOCKERHUB_USERNAME }}
+ password: ${{ secrets.DOCKERHUB_TOKEN }}
+ continue-on-error: true
+
+ - name: Build and push Docker image
+ uses: docker/build-push-action@v5
+ with:
+ context: ./agent
+ platforms: linux/amd64,linux/arm64
+ push: ${{ secrets.DOCKERHUB_USERNAME != '' }}
+ tags: |
+ serverkit/agent:latest
+ serverkit/agent:${{ steps.version.outputs.version }}
+ build-args: |
+ VERSION=${{ steps.version.outputs.version }}
+ BUILD_TIME=${{ github.event.repository.updated_at }}
+ GIT_COMMIT=${{ github.sha }}
+
release:
name: Create Release
runs-on: ubuntu-latest
- needs: build
+ needs: [build, build-deb, build-rpm, build-msi, build-docker]
permissions:
contents: write
@@ -114,7 +316,14 @@ jobs:
- name: Prepare release files
run: |
mkdir -p release
+ # Binary archives
find artifacts -type f \( -name "*.tar.gz" -o -name "*.zip" \) -exec mv {} release/ \;
+ # DEB packages
+ find artifacts -type f -name "*.deb" -exec mv {} release/ \;
+ # RPM packages
+ find artifacts -type f -name "*.rpm" -exec mv {} release/ \;
+ # MSI installers
+ find artifacts -type f -name "*.msi" -exec mv {} release/ \;
ls -la release/
- name: Generate checksums
@@ -137,22 +346,62 @@ jobs:
### Downloads
+ #### Binary Archives
| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x64 (amd64) | `serverkit-agent-${{ steps.version.outputs.version }}-linux-amd64.tar.gz` |
| Linux | ARM64 | `serverkit-agent-${{ steps.version.outputs.version }}-linux-arm64.tar.gz` |
| Windows | x64 (amd64) | `serverkit-agent-${{ steps.version.outputs.version }}-windows-amd64.zip` |
+ #### Linux Packages
+ | Format | Architecture | Download |
+ |--------|--------------|----------|
+ | DEB (Debian/Ubuntu) | amd64 | `serverkit-agent_${{ steps.version.outputs.version }}_amd64.deb` |
+ | DEB (Debian/Ubuntu) | arm64 | `serverkit-agent_${{ steps.version.outputs.version }}_arm64.deb` |
+ | RPM (RHEL/Fedora) | x86_64 | `serverkit-agent-${{ steps.version.outputs.version }}-1.x86_64.rpm` |
+ | RPM (RHEL/Fedora) | aarch64 | `serverkit-agent-${{ steps.version.outputs.version }}-1.aarch64.rpm` |
+
+ #### Windows Installer
+ | Format | Architecture | Download |
+ |--------|--------------|----------|
+ | MSI | x64 | `serverkit-agent-${{ steps.version.outputs.version }}-x64.msi` |
+
+ #### Docker
+ ```bash
+ docker pull serverkit/agent:${{ steps.version.outputs.version }}
+ docker pull serverkit/agent:latest
+ ```
+
### Quick Install
- **Linux (one-liner):**
+ **Debian/Ubuntu:**
```bash
- curl -fsSL https://your-serverkit.com/install.sh | sudo bash -s -- --token "YOUR_TOKEN"
+ curl -LO https://github.com/${{ github.repository }}/releases/download/agent-v${{ steps.version.outputs.version }}/serverkit-agent_${{ steps.version.outputs.version }}_amd64.deb
+ sudo dpkg -i serverkit-agent_${{ steps.version.outputs.version }}_amd64.deb
+ sudo serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+ sudo systemctl start serverkit-agent
```
- **Windows (PowerShell as Admin):**
+ **RHEL/Fedora:**
+ ```bash
+ sudo rpm -i https://github.com/${{ github.repository }}/releases/download/agent-v${{ steps.version.outputs.version }}/serverkit-agent-${{ steps.version.outputs.version }}-1.x86_64.rpm
+ sudo serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+ sudo systemctl start serverkit-agent
+ ```
+
+ **Windows (MSI):**
+ Download and run the MSI installer, then:
```powershell
- irm https://your-serverkit.com/install.ps1 | iex; Install-ServerKitAgent -Token "YOUR_TOKEN"
+ serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+ Start-Service ServerKitAgent
+ ```
+
+ **Docker:**
+ ```bash
+ docker run -d --name serverkit-agent \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v serverkit-config:/etc/serverkit-agent \
+ serverkit/agent:${{ steps.version.outputs.version }}
```
### Verification
@@ -171,7 +420,7 @@ jobs:
summary:
name: Build Summary
runs-on: ubuntu-latest
- needs: [build, release]
+ needs: [build, build-deb, build-rpm, build-msi, build-docker, release]
steps:
- name: Get version
@@ -198,6 +447,17 @@ jobs:
echo "| Linux | arm64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
echo "| Windows | amd64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
+ echo "### Packages" >> $GITHUB_STEP_SUMMARY
+ echo "" >> $GITHUB_STEP_SUMMARY
+ echo "| Format | Architecture | Status |" >> $GITHUB_STEP_SUMMARY
+ echo "|--------|--------------|--------|" >> $GITHUB_STEP_SUMMARY
+ echo "| DEB | amd64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "| DEB | arm64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "| RPM | x86_64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "| RPM | aarch64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "| MSI | x64 | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "| Docker | multi-arch | ✅ Built |" >> $GITHUB_STEP_SUMMARY
+ echo "" >> $GITHUB_STEP_SUMMARY
echo "### Release" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Release created at: https://github.com/${{ github.repository }}/releases/tag/agent-v${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
diff --git a/SERVERS_INTEGRATION_PLAN.md b/SERVERS_INTEGRATION_PLAN.md
index cf3ace18..991f6a6c 100644
--- a/SERVERS_INTEGRATION_PLAN.md
+++ b/SERVERS_INTEGRATION_PLAN.md
@@ -1290,7 +1290,7 @@ system:exec: # Requires explicit permission
[x] Volume/network listing
```
-### Phase 10.6: Monitoring & Metrics 🔄 IN PROGRESS
+### Phase 10.6: Monitoring & Metrics ✅ MOSTLY COMPLETE
**Duration: ~2 weeks**
```
@@ -1299,10 +1299,10 @@ system:exec: # Requires explicit permission
[x] WebSocket to frontend (SocketIO)
[x] Live dashboard updates
-[ ] Historical metrics
+[x] Historical metrics (partial)
[x] Metrics storage (ServerMetrics model)
- [ ] Retention policies
- [ ] Aggregation queries
+ [ ] Retention policies (future)
+ [ ] Aggregation queries (future)
[x] Cross-server dashboard
[x] Overview page (Servers.jsx)
@@ -1310,7 +1310,7 @@ system:exec: # Requires explicit permission
[x] Health grid view
```
-### Phase 10.7: Installation & Distribution ✅ MOSTLY COMPLETE
+### Phase 10.7: Installation & Distribution ✅ COMPLETE
**Duration: ~1-2 weeks**
```
@@ -1324,13 +1324,13 @@ system:exec: # Requires explicit permission
[x] Linux install script (bash) - created
[x] Windows install script (PowerShell) - created
[x] Installation endpoint in backend
- [ ] Docker image
+ [x] Docker image (Dockerfile + docker-compose.yml)
-[ ] Package building
- [ ] .deb packages
- [ ] .rpm packages
- [ ] .msi installer
- [ ] Homebrew formula
+[x] Package building
+ [x] .deb packages (packaging/deb/build.sh)
+ [x] .rpm packages (packaging/rpm/build.sh)
+ [x] .msi installer (packaging/msi/Product.wxs + build.ps1)
+ [ ] Homebrew formula (future)
[x] Auto-update system
[x] Version checking endpoint
@@ -1341,14 +1341,18 @@ system:exec: # Requires explicit permission
[x] Download page in UI
```
-### Phase 10.8: Advanced Features
+### Phase 10.8: Advanced Features 🔄 IN PROGRESS
**Duration: ~3-4 weeks**
```
-[ ] Docker Compose on remote servers
- [ ] Stack deployment
- [ ] Stack management
- [ ] Compose file editor
+[x] Docker Compose on remote servers
+ [x] Agent: Compose methods (list, ps, up, down, logs, restart, pull)
+ [x] Backend: RemoteDockerService compose methods
+ [x] Backend: API endpoints for compose operations
+ [x] Frontend: API methods for compose
+ [x] Frontend: ComposeTab in Docker page
+ [x] Frontend: ComposeLogsModal for viewing logs
+ [ ] Compose file editor (future)
[x] Container logs streaming
[x] Real-time log streaming via agent
@@ -1357,10 +1361,15 @@ system:exec: # Requires explicit permission
[ ] Log search/filter (future)
[ ] Download logs (future)
-[ ] Remote terminal (optional)
+[ ] Remote terminal (optional - lower priority)
[ ] PTY support in agent
[ ] Terminal UI component
[ ] Session management
+
+[ ] Historical metrics
+ [ ] Retention policies
+ [ ] Aggregation queries
+ [ ] Metrics visualization improvements
```
---
@@ -1522,6 +1531,6 @@ logging:
*This document is a living specification and will be updated as implementation progresses.*
-**Document Version**: 1.0.0
-**Last Updated**: 2026-01-21
+**Document Version**: 1.1.0
+**Last Updated**: 2026-01-22
**Author**: ServerKit Team
diff --git a/agent/.dockerignore b/agent/.dockerignore
new file mode 100644
index 00000000..a6833ea8
--- /dev/null
+++ b/agent/.dockerignore
@@ -0,0 +1,34 @@
+# Build artifacts
+*.exe
+serverkit-agent
+agent
+
+# Git
+.git
+.gitignore
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# Documentation (not needed in image)
+*.md
+LICENSE
+
+# Scripts (not needed in image)
+scripts/
+
+# Local config files
+config.yaml
+*.key
+*.pem
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Test files
+*_test.go
+testdata/
diff --git a/agent/Dockerfile b/agent/Dockerfile
new file mode 100644
index 00000000..d46ef179
--- /dev/null
+++ b/agent/Dockerfile
@@ -0,0 +1,81 @@
+# ServerKit Agent - Docker Image
+# Multi-stage build for minimal image size
+
+# ============================================
+# Stage 1: Build
+# ============================================
+FROM golang:1.21-alpine AS builder
+
+# Install build dependencies
+RUN apk add --no-cache git ca-certificates tzdata
+
+WORKDIR /build
+
+# Copy go mod files first for better layer caching
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy source code
+COPY . .
+
+# Build arguments for version info
+ARG VERSION=dev
+ARG BUILD_TIME=unknown
+ARG GIT_COMMIT=unknown
+
+# Build the agent binary
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
+ -ldflags="-w -s \
+ -X main.Version=${VERSION} \
+ -X main.BuildTime=${BUILD_TIME} \
+ -X main.GitCommit=${GIT_COMMIT}" \
+ -o serverkit-agent \
+ ./cmd/agent
+
+# ============================================
+# Stage 2: Runtime
+# ============================================
+FROM alpine:3.19
+
+# Install runtime dependencies
+RUN apk add --no-cache \
+ ca-certificates \
+ tzdata \
+ docker-cli \
+ docker-cli-compose
+
+# Create non-root user
+RUN addgroup -g 1000 serverkit && \
+ adduser -u 1000 -G serverkit -s /bin/sh -D serverkit
+
+# Create directories
+RUN mkdir -p /etc/serverkit-agent /var/log/serverkit-agent && \
+ chown -R serverkit:serverkit /etc/serverkit-agent /var/log/serverkit-agent
+
+# Copy binary from builder
+COPY --from=builder /build/serverkit-agent /usr/local/bin/serverkit-agent
+
+# Set permissions
+RUN chmod +x /usr/local/bin/serverkit-agent
+
+# Volume for configuration persistence
+VOLUME ["/etc/serverkit-agent"]
+
+# Volume for logs
+VOLUME ["/var/log/serverkit-agent"]
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+ CMD serverkit-agent status || exit 1
+
+# Labels
+LABEL org.opencontainers.image.title="ServerKit Agent" \
+ org.opencontainers.image.description="Remote server management agent for ServerKit" \
+ org.opencontainers.image.vendor="ServerKit" \
+ org.opencontainers.image.source="https://github.com/serverkit/serverkit"
+
+# Default user (can be overridden for Docker socket access)
+USER serverkit
+
+ENTRYPOINT ["serverkit-agent"]
+CMD ["start"]
diff --git a/agent/Makefile b/agent/Makefile
index fc71374c..9ef23088 100644
--- a/agent/Makefile
+++ b/agent/Makefile
@@ -12,7 +12,7 @@ LDFLAGS := -s -w \
BINARY_NAME := serverkit-agent
DIST_DIR := dist
-.PHONY: all build clean test lint deps dev run
+.PHONY: all build clean test lint deps dev run docker-build docker-push docker-buildx
all: build
@@ -92,6 +92,38 @@ install: build
checksums:
@cd $(DIST_DIR) && sha256sum * > checksums.txt
+# Docker image name
+DOCKER_IMAGE := serverkit/agent
+DOCKER_TAG ?= latest
+
+# Build Docker image
+docker-build:
+ docker build \
+ --build-arg VERSION=$(VERSION) \
+ --build-arg BUILD_TIME=$(BUILD_TIME) \
+ --build-arg GIT_COMMIT=$(GIT_COMMIT) \
+ -t $(DOCKER_IMAGE):$(DOCKER_TAG) .
+
+# Build and tag Docker image with version
+docker-build-version: docker-build
+ docker tag $(DOCKER_IMAGE):$(DOCKER_TAG) $(DOCKER_IMAGE):$(VERSION)
+
+# Push Docker image
+docker-push:
+ docker push $(DOCKER_IMAGE):$(DOCKER_TAG)
+ docker push $(DOCKER_IMAGE):$(VERSION)
+
+# Build multi-arch Docker image
+docker-buildx:
+ docker buildx build \
+ --platform linux/amd64,linux/arm64 \
+ --build-arg VERSION=$(VERSION) \
+ --build-arg BUILD_TIME=$(BUILD_TIME) \
+ --build-arg GIT_COMMIT=$(GIT_COMMIT) \
+ -t $(DOCKER_IMAGE):$(DOCKER_TAG) \
+ -t $(DOCKER_IMAGE):$(VERSION) \
+ --push .
+
# Help
help:
@echo "ServerKit Agent Build System"
@@ -99,16 +131,22 @@ help:
@echo "Usage: make [target]"
@echo ""
@echo "Targets:"
- @echo " build Build for current platform"
- @echo " build-all Build for all platforms"
- @echo " build-linux Build for Linux only"
- @echo " build-windows Build for Windows only"
- @echo " dev Build with debug symbols"
- @echo " run Build and run the agent"
- @echo " test Run tests"
- @echo " lint Run linter"
- @echo " fmt Format code"
- @echo " clean Remove build artifacts"
- @echo " deps Download dependencies"
- @echo " install Install to /usr/local/bin"
- @echo " help Show this help"
+ @echo " build Build for current platform"
+ @echo " build-all Build for all platforms"
+ @echo " build-linux Build for Linux only"
+ @echo " build-windows Build for Windows only"
+ @echo " dev Build with debug symbols"
+ @echo " run Build and run the agent"
+ @echo " test Run tests"
+ @echo " lint Run linter"
+ @echo " fmt Format code"
+ @echo " clean Remove build artifacts"
+ @echo " deps Download dependencies"
+ @echo " install Install to /usr/local/bin"
+ @echo ""
+ @echo "Docker:"
+ @echo " docker-build Build Docker image"
+ @echo " docker-push Push Docker image to registry"
+ @echo " docker-buildx Build multi-arch image (amd64, arm64)"
+ @echo ""
+ @echo " help Show this help"
diff --git a/agent/README.md b/agent/README.md
index b4e9f5d8..f19fc049 100644
--- a/agent/README.md
+++ b/agent/README.md
@@ -29,6 +29,66 @@ irm https://your-serverkit.com/install.ps1 | iex
Install-ServerKitAgent -Token "sk_reg_your_token" -Server "https://your-serverkit.com"
```
+### Docker (Recommended for containerized environments)
+
+```bash
+# Pull the image
+docker pull serverkit/agent:latest
+
+# Register the agent (one-time setup)
+docker run --rm -v serverkit-agent-config:/etc/serverkit-agent \
+ serverkit/agent:latest register \
+ --token "sk_reg_your_token" \
+ --server "https://your-serverkit.com"
+
+# Start the agent
+docker run -d --name serverkit-agent \
+ --restart unless-stopped \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v serverkit-agent-config:/etc/serverkit-agent \
+ serverkit/agent:latest
+```
+
+Or use Docker Compose:
+
+```bash
+# Clone and navigate to agent directory
+cd agent
+
+# Register (one-time setup)
+docker compose run --rm agent register -s https://your-serverkit.com -t YOUR_TOKEN
+
+# Start the agent
+docker compose up -d
+
+# View logs
+docker compose logs -f
+```
+
+### Package Installation
+
+**Debian/Ubuntu (.deb):**
+```bash
+curl -LO https://github.com/serverkit/serverkit/releases/latest/download/serverkit-agent_VERSION_amd64.deb
+sudo dpkg -i serverkit-agent_VERSION_amd64.deb
+sudo serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+sudo systemctl start serverkit-agent
+```
+
+**RHEL/CentOS/Fedora (.rpm):**
+```bash
+sudo rpm -i https://github.com/serverkit/serverkit/releases/latest/download/serverkit-agent-VERSION-1.x86_64.rpm
+sudo serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+sudo systemctl start serverkit-agent
+```
+
+**Windows (.msi):**
+Download and run the MSI installer from the releases page, then:
+```powershell
+serverkit-agent register --token "YOUR_TOKEN" --server "https://your-serverkit.com"
+Start-Service ServerKitAgent
+```
+
### Manual Installation
1. Download the appropriate binary for your platform from the releases page
@@ -210,6 +270,92 @@ Get-Content "C:\ProgramData\ServerKit\Agent\logs\agent.log" -Tail 50
Restart-Service ServerKitAgent
```
+## Docker Deployment
+
+### Building the Image
+
+```bash
+cd agent
+
+# Build with version info
+docker build \
+ --build-arg VERSION=1.0.0 \
+ --build-arg BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
+ --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) \
+ -t serverkit/agent:latest .
+```
+
+### Running with Docker
+
+```bash
+# Register the agent first
+docker run --rm \
+ -v serverkit-agent-config:/etc/serverkit-agent \
+ serverkit/agent:latest register \
+ --token "sk_reg_xxx" \
+ --server "https://your-serverkit.com" \
+ --name "my-server"
+
+# Run the agent
+docker run -d \
+ --name serverkit-agent \
+ --restart unless-stopped \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ -v serverkit-agent-config:/etc/serverkit-agent \
+ -v serverkit-agent-logs:/var/log/serverkit-agent \
+ serverkit/agent:latest
+```
+
+### Running with Docker Compose
+
+```yaml
+# docker-compose.yml
+services:
+ agent:
+ image: serverkit/agent:latest
+ container_name: serverkit-agent
+ restart: unless-stopped
+ user: root
+ volumes:
+ - /var/run/docker.sock:/var/run/docker.sock:ro
+ - serverkit-config:/etc/serverkit-agent
+ - serverkit-logs:/var/log/serverkit-agent
+ environment:
+ - TZ=UTC
+
+volumes:
+ serverkit-config:
+ serverkit-logs:
+```
+
+```bash
+# Register
+docker compose run --rm agent register -s https://your-serverkit.com -t YOUR_TOKEN
+
+# Start
+docker compose up -d
+
+# Logs
+docker compose logs -f
+
+# Stop
+docker compose down
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `TZ` | Timezone | `UTC` |
+
+### Volumes
+
+| Path | Description |
+|------|-------------|
+| `/etc/serverkit-agent` | Configuration and credentials |
+| `/var/log/serverkit-agent` | Log files |
+| `/var/run/docker.sock` | Docker socket (mount read-only) |
+
## Development
### Project Structure
diff --git a/agent/docker-compose.yml b/agent/docker-compose.yml
new file mode 100644
index 00000000..576c3fc0
--- /dev/null
+++ b/agent/docker-compose.yml
@@ -0,0 +1,69 @@
+# ServerKit Agent - Docker Compose Configuration
+#
+# Usage:
+# 1. Register first (one-time setup):
+# docker compose run --rm agent register -s https://your-serverkit.com -t YOUR_TOKEN
+#
+# 2. Start the agent:
+# docker compose up -d
+#
+# 3. View logs:
+# docker compose logs -f
+#
+# 4. Stop the agent:
+# docker compose down
+
+services:
+ agent:
+ image: serverkit/agent:latest
+ container_name: serverkit-agent
+ restart: unless-stopped
+
+ # Run as root to access Docker socket
+ # The agent drops privileges internally where possible
+ user: root
+
+ volumes:
+ # Docker socket for container management
+ - /var/run/docker.sock:/var/run/docker.sock:ro
+
+ # Persist configuration between restarts
+ - serverkit-config:/etc/serverkit-agent
+
+ # Persist logs
+ - serverkit-logs:/var/log/serverkit-agent
+
+ environment:
+ # Optional: Set timezone
+ - TZ=UTC
+
+ # Optional: Resource limits
+ deploy:
+ resources:
+ limits:
+ cpus: '0.5'
+ memory: 256M
+ reservations:
+ cpus: '0.1'
+ memory: 64M
+
+ # Health check
+ healthcheck:
+ test: ["CMD", "serverkit-agent", "status"]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 10s
+
+ # Logging configuration
+ logging:
+ driver: "json-file"
+ options:
+ max-size: "10m"
+ max-file: "3"
+
+volumes:
+ serverkit-config:
+ name: serverkit-agent-config
+ serverkit-logs:
+ name: serverkit-agent-logs
diff --git a/agent/packaging/deb/build.sh b/agent/packaging/deb/build.sh
new file mode 100644
index 00000000..fbc4b6c0
--- /dev/null
+++ b/agent/packaging/deb/build.sh
@@ -0,0 +1,219 @@
+#!/bin/bash
+# Build .deb package for ServerKit Agent
+# Usage: ./build.sh <version> <architecture> <binary_path>
+# Example: ./build.sh 1.0.0 amd64 ../../dist/serverkit-agent-linux-amd64
+
+set -e
+
+VERSION="${1:-1.0.0}"
+ARCH="${2:-amd64}"
+BINARY_PATH="${3:-../../dist/serverkit-agent-linux-$ARCH}"
+PACKAGE_NAME="serverkit-agent"
+MAINTAINER="ServerKit <[email protected]>"
+DESCRIPTION="ServerKit Agent - Remote server management agent"
+
+# Map Go arch to Debian arch
+case "$ARCH" in
+ amd64) DEB_ARCH="amd64" ;;
+ arm64) DEB_ARCH="arm64" ;;
+ arm) DEB_ARCH="armhf" ;;
+ *) DEB_ARCH="$ARCH" ;;
+esac
+
+echo "Building .deb package..."
+echo " Version: $VERSION"
+echo " Architecture: $DEB_ARCH"
+echo " Binary: $BINARY_PATH"
+
+# Create build directory
+BUILD_DIR="$(mktemp -d)"
+PKG_DIR="$BUILD_DIR/${PACKAGE_NAME}_${VERSION}_${DEB_ARCH}"
+
+# Create directory structure
+mkdir -p "$PKG_DIR/DEBIAN"
+mkdir -p "$PKG_DIR/usr/local/bin"
+mkdir -p "$PKG_DIR/etc/serverkit-agent"
+mkdir -p "$PKG_DIR/var/log/serverkit-agent"
+mkdir -p "$PKG_DIR/lib/systemd/system"
+
+# Copy binary
+cp "$BINARY_PATH" "$PKG_DIR/usr/local/bin/serverkit-agent"
+chmod 755 "$PKG_DIR/usr/local/bin/serverkit-agent"
+
+# Create control file
+cat > "$PKG_DIR/DEBIAN/control" << EOF
+Package: $PACKAGE_NAME
+Version: $VERSION
+Section: admin
+Priority: optional
+Architecture: $DEB_ARCH
+Maintainer: $MAINTAINER
+Description: $DESCRIPTION
+ ServerKit Agent connects your server to a ServerKit control plane,
+ enabling remote Docker management, monitoring, and more.
+ .
+ Features:
+ - Docker container management
+ - System metrics collection
+ - Secure WebSocket communication
+ - Auto-reconnect with exponential backoff
+Depends: ca-certificates
+Suggests: docker-ce | docker.io
+Homepage: https://github.com/serverkit/serverkit
+EOF
+
+# Create conffiles (list of config files that shouldn't be overwritten)
+cat > "$PKG_DIR/DEBIAN/conffiles" << EOF
+/etc/serverkit-agent/config.yaml
+EOF
+
+# Create systemd service file
+cat > "$PKG_DIR/lib/systemd/system/serverkit-agent.service" << EOF
+[Unit]
+Description=ServerKit Agent
+Documentation=https://github.com/serverkit/serverkit
+After=network-online.target docker.service
+Wants=network-online.target
+Requires=docker.service
+
+[Service]
+Type=simple
+User=root
+ExecStart=/usr/local/bin/serverkit-agent start
+Restart=always
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+
+# Security hardening
+NoNewPrivileges=false
+ProtectSystem=strict
+ProtectHome=read-only
+ReadWritePaths=/etc/serverkit-agent /var/log/serverkit-agent
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# Create default config file
+cat > "$PKG_DIR/etc/serverkit-agent/config.yaml" << EOF
+# ServerKit Agent Configuration
+# This file is created during installation.
+# Run 'serverkit-agent register' to configure the agent.
+
+server:
+ url: ""
+ reconnect_interval: 5s
+ max_reconnect_interval: 5m
+ ping_interval: 30s
+
+agent:
+ id: ""
+ name: ""
+
+features:
+ docker: true
+ metrics: true
+ logs: true
+ file_access: false
+ exec: false
+
+metrics:
+ enabled: true
+ interval: 10s
+
+docker:
+ socket: /var/run/docker.sock
+ timeout: 30s
+
+logging:
+ level: info
+ file: /var/log/serverkit-agent/agent.log
+ max_size_mb: 100
+ max_backups: 5
+ max_age_days: 30
+ compress: true
+EOF
+
+# Create postinst script
+cat > "$PKG_DIR/DEBIAN/postinst" << 'EOF'
+#!/bin/bash
+set -e
+
+case "$1" in
+ configure)
+ # Reload systemd
+ systemctl daemon-reload
+
+ # Enable service (but don't start - user needs to register first)
+ systemctl enable serverkit-agent.service || true
+
+ echo ""
+ echo "ServerKit Agent installed successfully!"
+ echo ""
+ echo "To complete setup:"
+ echo " 1. Register the agent:"
+ echo " sudo serverkit-agent register --token YOUR_TOKEN --server https://your-serverkit.com"
+ echo ""
+ echo " 2. Start the service:"
+ echo " sudo systemctl start serverkit-agent"
+ echo ""
+ echo " 3. Check status:"
+ echo " sudo systemctl status serverkit-agent"
+ echo ""
+ ;;
+esac
+
+exit 0
+EOF
+chmod 755 "$PKG_DIR/DEBIAN/postinst"
+
+# Create prerm script
+cat > "$PKG_DIR/DEBIAN/prerm" << 'EOF'
+#!/bin/bash
+set -e
+
+case "$1" in
+ remove|upgrade)
+ # Stop service
+ systemctl stop serverkit-agent.service || true
+ systemctl disable serverkit-agent.service || true
+ ;;
+esac
+
+exit 0
+EOF
+chmod 755 "$PKG_DIR/DEBIAN/prerm"
+
+# Create postrm script
+cat > "$PKG_DIR/DEBIAN/postrm" << 'EOF'
+#!/bin/bash
+set -e
+
+case "$1" in
+ purge)
+ # Remove config and log directories
+ rm -rf /etc/serverkit-agent
+ rm -rf /var/log/serverkit-agent
+ ;;
+ remove)
+ # Reload systemd
+ systemctl daemon-reload || true
+ ;;
+esac
+
+exit 0
+EOF
+chmod 755 "$PKG_DIR/DEBIAN/postrm"
+
+# Build the package
+OUTPUT_DIR="${4:-./output}"
+mkdir -p "$OUTPUT_DIR"
+dpkg-deb --build --root-owner-group "$PKG_DIR" "$OUTPUT_DIR/${PACKAGE_NAME}_${VERSION}_${DEB_ARCH}.deb"
+
+# Cleanup
+rm -rf "$BUILD_DIR"
+
+echo ""
+echo "Package built successfully!"
+echo "Output: $OUTPUT_DIR/${PACKAGE_NAME}_${VERSION}_${DEB_ARCH}.deb"
diff --git a/agent/packaging/msi/Product.wxs b/agent/packaging/msi/Product.wxs
new file mode 100644
index 00000000..057f6d95
--- /dev/null
+++ b/agent/packaging/msi/Product.wxs
@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ ServerKit Agent - Windows MSI Installer
+ Built with WiX Toolset v4
+
+ Build instructions:
+ 1. Install WiX Toolset v4
+ 2. Run: wix build Product.wxs -o serverkit-agent.msi
+-->
+<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs">
+
+ <!-- Product definition -->
+ <Package
+ Name="ServerKit Agent"
+ Manufacturer="ServerKit"
+ Version="!(bind.FileVersion.ServerKitAgentExe)"
+ UpgradeCode="E8B7F3A2-4C5D-4E6F-8A9B-0C1D2E3F4A5B"
+ Scope="perMachine">
+
+ <SummaryInformation
+ Description="ServerKit Agent - Remote server management agent"
+ Keywords="ServerKit,Agent,Docker,Management"
+ Manufacturer="ServerKit" />
+
+ <!-- Upgrade handling -->
+ <MajorUpgrade
+ DowngradeErrorMessage="A newer version of [ProductName] is already installed."
+ Schedule="afterInstallInitialize" />
+
+ <!-- Media -->
+ <MediaTemplate EmbedCab="yes" />
+
+ <!-- License -->
+ <WixVariable Id="WixUILicenseRtf" Value="License.rtf" />
+
+ <!-- UI -->
+ <UI>
+ <UIRef Id="WixUI_InstallDir" />
+ <Property Id="WIXUI_INSTALLDIR" Value="INSTALLFOLDER" />
+ </UI>
+
+ <!-- Feature -->
+ <Feature Id="ProductFeature" Title="ServerKit Agent" Level="1">
+ <ComponentGroupRef Id="ProductComponents" />
+ <ComponentRef Id="ServiceComponent" />
+ <ComponentRef Id="ConfigComponent" />
+ </Feature>
+
+ <!-- Custom Actions -->
+ <CustomAction Id="StopService"
+ Directory="INSTALLFOLDER"
+ ExeCommand="[SystemFolder]net.exe stop ServerKitAgent"
+ Execute="deferred"
+ Impersonate="no"
+ Return="ignore" />
+
+ <CustomAction Id="StartService"
+ Directory="INSTALLFOLDER"
+ ExeCommand="[SystemFolder]net.exe start ServerKitAgent"
+ Execute="deferred"
+ Impersonate="no"
+ Return="ignore" />
+
+ <InstallExecuteSequence>
+ <Custom Action="StopService" Before="InstallFiles">
+ Installed AND NOT UPGRADINGPRODUCTCODE
+ </Custom>
+ </InstallExecuteSequence>
+ </Package>
+
+ <!-- Directory Structure -->
+ <Fragment>
+ <StandardDirectory Id="ProgramFiles64Folder">
+ <Directory Id="INSTALLFOLDER" Name="ServerKit Agent">
+ <Directory Id="LogsFolder" Name="logs" />
+ </Directory>
+ </StandardDirectory>
+
+ <StandardDirectory Id="CommonAppDataFolder">
+ <Directory Id="ServerKitDataFolder" Name="ServerKit">
+ <Directory Id="AgentDataFolder" Name="Agent" />
+ </Directory>
+ </StandardDirectory>
+ </Fragment>
+
+ <!-- Components -->
+ <Fragment>
+ <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
+ <Component Id="MainExecutable" Guid="A1B2C3D4-E5F6-7890-ABCD-EF1234567890">
+ <File Id="ServerKitAgentExe"
+ Source="serverkit-agent.exe"
+ KeyPath="yes">
+ <Shortcut Id="StartMenuShortcut"
+ Directory="ProgramMenuFolder"
+ Name="ServerKit Agent"
+ Description="ServerKit Agent Management"
+ WorkingDirectory="INSTALLFOLDER"
+ Advertise="yes" />
+ </File>
+ </Component>
+ </ComponentGroup>
+
+ <!-- Windows Service -->
+ <Component Id="ServiceComponent" Directory="INSTALLFOLDER" Guid="B2C3D4E5-F6A7-8901-BCDE-F23456789012">
+ <File Id="ServiceExe" Source="serverkit-agent.exe" KeyPath="yes" />
+ <ServiceInstall
+ Id="ServiceInstall"
+ Name="ServerKitAgent"
+ DisplayName="ServerKit Agent"
+ Description="ServerKit Agent - Remote server management service"
+ Type="ownProcess"
+ Start="auto"
+ ErrorControl="normal"
+ Arguments="start">
+ <ServiceDependency Id="Tcpip" />
+ </ServiceInstall>
+ <ServiceControl
+ Id="ServiceControl"
+ Name="ServerKitAgent"
+ Start="install"
+ Stop="both"
+ Remove="uninstall"
+ Wait="yes" />
+ </Component>
+
+ <!-- Configuration -->
+ <Component Id="ConfigComponent" Directory="AgentDataFolder" Guid="C3D4E5F6-A7B8-9012-CDEF-345678901234">
+ <File Id="ConfigYaml" Source="config.yaml" KeyPath="yes" />
+ <RemoveFile Id="RemoveConfig" Name="config.yaml" On="uninstall" />
+ <RemoveFile Id="RemoveKey" Name="agent.key" On="uninstall" />
+ <RemoveFolder Id="RemoveAgentDataFolder" On="uninstall" />
+ </Component>
+ </Fragment>
+
+</Wix>
diff --git a/agent/packaging/msi/build.ps1 b/agent/packaging/msi/build.ps1
new file mode 100644
index 00000000..4b4e9c75
--- /dev/null
+++ b/agent/packaging/msi/build.ps1
@@ -0,0 +1,123 @@
+# Build MSI installer for ServerKit Agent
+# Usage: .\build.ps1 -Version "1.0.0" -BinaryPath "..\dist\serverkit-agent-windows-amd64.exe"
+
+param(
+ [string]$Version = "1.0.0",
+ [string]$BinaryPath = "..\..\dist\serverkit-agent-windows-amd64.exe",
+ [string]$OutputDir = ".\output"
+)
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "Building MSI installer..."
+Write-Host " Version: $Version"
+Write-Host " Binary: $BinaryPath"
+
+# Check for WiX Toolset
+$wixPath = Get-Command wix -ErrorAction SilentlyContinue
+if (-not $wixPath) {
+ Write-Host "WiX Toolset not found. Please install it first:"
+ Write-Host " winget install WixToolset.WixToolset"
+ Write-Host " or download from: https://wixtoolset.org/"
+ exit 1
+}
+
+# Create build directory
+$buildDir = New-Item -ItemType Directory -Force -Path "$env:TEMP\serverkit-msi-build-$(Get-Random)"
+Write-Host "Build directory: $buildDir"
+
+try {
+ # Copy binary
+ Copy-Item $BinaryPath "$buildDir\serverkit-agent.exe"
+
+ # Create default config file
+ $configContent = @"
+# ServerKit Agent Configuration
+# This file is created during installation.
+# Run 'serverkit-agent register' to configure the agent.
+
+server:
+ url: ""
+ reconnect_interval: 5s
+ max_reconnect_interval: 5m
+ ping_interval: 30s
+
+agent:
+ id: ""
+ name: ""
+
+features:
+ docker: true
+ metrics: true
+ logs: true
+ file_access: false
+ exec: false
+
+metrics:
+ enabled: true
+ interval: 10s
+
+docker:
+ socket: npipe:////./pipe/docker_engine
+ timeout: 30s
+
+logging:
+ level: info
+ file: C:\ProgramData\ServerKit\Agent\logs\agent.log
+ max_size_mb: 100
+ max_backups: 5
+ max_age_days: 30
+ compress: true
+"@
+ $configContent | Out-File -FilePath "$buildDir\config.yaml" -Encoding UTF8
+
+ # Create license file (RTF format required by WiX)
+ $licenseContent = @"
+{\rtf1\ansi\deff0
+{\fonttbl{\f0 Consolas;}}
+\f0\fs20
+MIT License\par
+\par
+Copyright (c) 2024 ServerKit\par
+\par
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:\par
+\par
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.\par
+\par
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\par
+}
+"@
+ $licenseContent | Out-File -FilePath "$buildDir\License.rtf" -Encoding ASCII
+
+ # Copy WiX source
+ Copy-Item "Product.wxs" "$buildDir\"
+
+ # Create output directory
+ New-Item -ItemType Directory -Force -Path $OutputDir | Out-Null
+
+ # Build MSI
+ Push-Location $buildDir
+ try {
+ Write-Host "Running WiX build..."
+ wix build Product.wxs -o "$OutputDir\serverkit-agent-$Version-x64.msi" -define Version=$Version
+ }
+ finally {
+ Pop-Location
+ }
+
+ Write-Host ""
+ Write-Host "MSI built successfully!"
+ Write-Host "Output: $OutputDir\serverkit-agent-$Version-x64.msi"
+}
+finally {
+ # Cleanup
+ Remove-Item -Recurse -Force $buildDir -ErrorAction SilentlyContinue
+}
diff --git a/agent/packaging/rpm/build.sh b/agent/packaging/rpm/build.sh
new file mode 100644
index 00000000..2b058cf0
--- /dev/null
+++ b/agent/packaging/rpm/build.sh
@@ -0,0 +1,206 @@
+#!/bin/bash
+# Build .rpm package for ServerKit Agent
+# Usage: ./build.sh <version> <architecture> <binary_path>
+# Example: ./build.sh 1.0.0 x86_64 ../../dist/serverkit-agent-linux-amd64
+
+set -e
+
+VERSION="${1:-1.0.0}"
+ARCH="${2:-x86_64}"
+BINARY_PATH="${3:-../../dist/serverkit-agent-linux-amd64}"
+PACKAGE_NAME="serverkit-agent"
+
+# Map Go arch to RPM arch
+case "$ARCH" in
+ amd64) RPM_ARCH="x86_64" ;;
+ arm64) RPM_ARCH="aarch64" ;;
+ *) RPM_ARCH="$ARCH" ;;
+esac
+
+echo "Building .rpm package..."
+echo " Version: $VERSION"
+echo " Architecture: $RPM_ARCH"
+echo " Binary: $BINARY_PATH"
+
+# Create build directory structure
+BUILD_ROOT="$(mktemp -d)"
+mkdir -p "$BUILD_ROOT"/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
+
+# Create source tarball
+SOURCE_DIR="$BUILD_ROOT/SOURCES/serverkit-agent-$VERSION"
+mkdir -p "$SOURCE_DIR"
+
+# Copy binary
+cp "$BINARY_PATH" "$SOURCE_DIR/serverkit-agent"
+
+# Create systemd service file
+cat > "$SOURCE_DIR/serverkit-agent.service" << EOF
+[Unit]
+Description=ServerKit Agent
+Documentation=https://github.com/serverkit/serverkit
+After=network-online.target docker.service
+Wants=network-online.target
+Requires=docker.service
+
+[Service]
+Type=simple
+User=root
+ExecStart=/usr/local/bin/serverkit-agent start
+Restart=always
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+
+# Security hardening
+NoNewPrivileges=false
+ProtectSystem=strict
+ProtectHome=read-only
+ReadWritePaths=/etc/serverkit-agent /var/log/serverkit-agent
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# Create default config file
+cat > "$SOURCE_DIR/config.yaml" << EOF
+# ServerKit Agent Configuration
+# This file is created during installation.
+# Run 'serverkit-agent register' to configure the agent.
+
+server:
+ url: ""
+ reconnect_interval: 5s
+ max_reconnect_interval: 5m
+ ping_interval: 30s
+
+agent:
+ id: ""
+ name: ""
+
+features:
+ docker: true
+ metrics: true
+ logs: true
+ file_access: false
+ exec: false
+
+metrics:
+ enabled: true
+ interval: 10s
+
+docker:
+ socket: /var/run/docker.sock
+ timeout: 30s
+
+logging:
+ level: info
+ file: /var/log/serverkit-agent/agent.log
+ max_size_mb: 100
+ max_backups: 5
+ max_age_days: 30
+ compress: true
+EOF
+
+# Create tarball
+cd "$BUILD_ROOT/SOURCES"
+tar -czvf "serverkit-agent-$VERSION.tar.gz" "serverkit-agent-$VERSION"
+rm -rf "serverkit-agent-$VERSION"
+
+# Create spec file
+cat > "$BUILD_ROOT/SPECS/serverkit-agent.spec" << EOF
+Name: serverkit-agent
+Version: $VERSION
+Release: 1%{?dist}
+Summary: ServerKit Agent - Remote server management agent
+
+License: MIT
+URL: https://github.com/serverkit/serverkit
+Source0: serverkit-agent-%{version}.tar.gz
+
+BuildArch: $RPM_ARCH
+Requires: ca-certificates
+
+%description
+ServerKit Agent connects your server to a ServerKit control plane,
+enabling remote Docker management, monitoring, and more.
+
+Features:
+- Docker container management
+- System metrics collection
+- Secure WebSocket communication
+- Auto-reconnect with exponential backoff
+
+%prep
+%setup -q
+
+%install
+rm -rf %{buildroot}
+
+# Install binary
+install -D -m 755 serverkit-agent %{buildroot}/usr/local/bin/serverkit-agent
+
+# Install systemd service
+install -D -m 644 serverkit-agent.service %{buildroot}/usr/lib/systemd/system/serverkit-agent.service
+
+# Install config directory and default config
+install -D -m 644 config.yaml %{buildroot}/etc/serverkit-agent/config.yaml
+
+# Create log directory
+install -d -m 755 %{buildroot}/var/log/serverkit-agent
+
+%files
+%attr(755, root, root) /usr/local/bin/serverkit-agent
+%attr(644, root, root) /usr/lib/systemd/system/serverkit-agent.service
+%config(noreplace) %attr(644, root, root) /etc/serverkit-agent/config.yaml
+%dir %attr(755, root, root) /etc/serverkit-agent
+%dir %attr(755, root, root) /var/log/serverkit-agent
+
+%post
+%systemd_post serverkit-agent.service
+
+echo ""
+echo "ServerKit Agent installed successfully!"
+echo ""
+echo "To complete setup:"
+echo " 1. Register the agent:"
+echo " sudo serverkit-agent register --token YOUR_TOKEN --server https://your-serverkit.com"
+echo ""
+echo " 2. Start the service:"
+echo " sudo systemctl start serverkit-agent"
+echo ""
+echo " 3. Check status:"
+echo " sudo systemctl status serverkit-agent"
+echo ""
+
+%preun
+%systemd_preun serverkit-agent.service
+
+%postun
+%systemd_postun_with_restart serverkit-agent.service
+
+if [ \$1 -eq 0 ]; then
+ # Complete uninstall - remove config and logs
+ rm -rf /etc/serverkit-agent 2>/dev/null || true
+ rm -rf /var/log/serverkit-agent 2>/dev/null || true
+fi
+
+%changelog
+* $(date '+%a %b %d %Y') ServerKit <[email protected]> - $VERSION-1
+- Release $VERSION
+EOF
+
+# Build the RPM
+rpmbuild --define "_topdir $BUILD_ROOT" -bb "$BUILD_ROOT/SPECS/serverkit-agent.spec"
+
+# Copy output
+OUTPUT_DIR="${4:-./output}"
+mkdir -p "$OUTPUT_DIR"
+cp "$BUILD_ROOT/RPMS/$RPM_ARCH"/*.rpm "$OUTPUT_DIR/"
+
+# Cleanup
+rm -rf "$BUILD_ROOT"
+
+echo ""
+echo "Package built successfully!"
+echo "Output: $OUTPUT_DIR/"
+ls -la "$OUTPUT_DIR"/*.rpm