yuan-lab-llm--clawmanager/docs/arm64-deployment_en.md

ARM64 Deployment Guide

ARM64 Platform Support

This project supports deployment on ARM64 (aarch64) architecture devices such as Raspberry Pi and ARM development boards.

Pre-built ARM64 Images

The following images can be used for ARM64 deployments:

Image	Address	Description
ClawManager Main App	ghcr.io/yuan-lab-llm/clawmanager:latest	Official multi-platform image with ARM64 support
Skill Scanner	ghcr.io/yuan-lab-llm/skill-scanner:latest	Official image now supports ARM64

Using Pre-built Images

# Pull ARM64 images
docker pull ghcr.io/yuan-lab-llm/clawmanager:latest --platform linux/arm64
docker pull ghcr.io/yuan-lab-llm/skill-scanner:latest --platform linux/arm64

Building ARM64 Images from Source

Backend Static Compilation

cd backend
CGO_ENABLED=0 go build -ldflags="-s -w -extldflags=-static" -o bin/clawreef-server ./cmd/server

Docker Multi-platform Build

# Build and push multi-platform images
docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/your-name/clawmanager:latest --push .

skill-scanner ARM64 Build (Optional)

ghcr.io/yuan-lab-llm/skill-scanner:latest now supports ARM64.

Build from source only if you need a customized image:

# Clone the repo
git clone https://github.com/Yuan-lab-LLM/skill-scanner.git
cd skill-scanner

# Use proxy if needed (for China networks)
export http_proxy="http://your-proxy:port"
export https_proxy="http://your-proxy:port"

# Build and push ARM64 image
docker buildx build --platform linux/arm64 \
  -t ghcr.io/your-name/skill-scanner:latest \
  --push .

Kubernetes ARM64 Deployment

Modify Image Addresses

In clawmanager.yaml, make sure the image addresses support ARM64:

# Main app
image: ghcr.io/yuan-lab-llm/clawmanager:latest

# skill-scanner (if needed)
image: ghcr.io/yuan-lab-llm/skill-scanner:latest

Database Initialization

Manual database user creation is required for first deployment:

kubectl exec -it -n clawmanager-system mysql-xxx -- mysql -u root

# Execute in MySQL
CREATE USER IF NOT EXISTS 'clawmanager'@'%' IDENTIFIED BY 'your-password';
GRANT ALL PRIVILEGES ON *.* TO 'clawmanager'@'%' WITH GRANT OPTION;
CREATE DATABASE IF NOT EXISTS clawmanager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
FLUSH PRIVILEGES;

Known Issues

ClawManager Official Image Supports ARM64

• Status: ghcr.io/yuan-lab-llm/clawmanager:latest is published as a multi-platform image
• Platforms: linux/amd64, linux/arm64
• Deployment impact: ARM64 nodes automatically pull the matching main app image without a separate ARM-only tag

skill-scanner Official Image Supports ARM64

• Status: ghcr.io/yuan-lab-llm/skill-scanner:latest now provides ARM64 image
• Deployment impact: ARM64 nodes automatically pull the matching architecture image
• Recommendation: pin a specific tag instead of latest for reproducible deployments

ARM64 Device Performance Notes

• Recommended device memory >= 4GB
• Recommended SSD storage (project data directory /mnt/Storage1)
• Recommended swap configuration to avoid OOM

Tested Environment

The following environment has been verified to work:

• Board: S922X-Oes-Plus (Amlogic S922X)
• OS: Armbian OS 26.05.0 trixie
• Kernel: 6.12.80-ophub
• Memory: 3.6GB RAM
• Storage: 110GB SSD
• Cluster: k3s v1.34.6