---
name: Multi-Architektur Support
description: Backend und Frontend müssen auf ARM64, x86, und AMD64 laufen
type: feedback
---

Das System muss auf **mehreren CPU-Architekturen** funktionieren:

**Why:** Der Pi ist ARM64, aber Production-Server sind oft x86/AMD64. Development kann auf verschiedenen Maschinen stattfinden.

**How to apply:**

## Backend (Python/FastAPI)

✅ **Bereits kompatibel** – Python ist plattformübergreifend:
- Keine CPU-spezifischen Dependencies
- subprocess.run() funktioniert überall
- Nur: pwd/grp/pathlib/socket = Standard Library (überall verfügbar)

⚠️ **Zu achten:**
- `psutil` optional (nur in system_info.py, mit Fallback)
- Systemd-spezifisch: `systemctl`, `useradd`, `groupdel` – nur auf Linux
- ZFS Tools müssen installiert sein (zpool, zfs Binaries)

✓ **Test vor Deployment:**
```bash
# ARM64 Pi:
python3 main.py
# x86/AMD64 Server:
python3 main.py
```

## Frontend (Next.js/React)

⚠️ **Wichtig:** Next.js baut zu **JavaScript/HTML** – läuft überall:
- `npm run build` auf jedem OS (Windows/Mac/Linux)
- Output ist plattformunabhängig (static HTML/JS)
- Runtime (Node.js) auch auf allen Architekturen

⚠️ **Aber:** Build kann unterschiedlich lange dauern:
- Pi: 20-30min (ARM64 ist langsam)
- x86/AMD64: 2-5min

**Strategie:** Build auf stärkerem Server, Deploy überall.

## Deployment-Matrix

```
┌──────────────┬────────────┬────────────┬──────────────┐
│ Architektur  │ Python     │ Next.js    │ ZFS Tools    │
├──────────────┼────────────┼────────────┼──────────────┤
│ ARM64 (Pi)   │ ✓ läuft    │ ✓ läuft    │ ✓ installiert│
│ x86 (32bit)  │ ✓ läuft    │ ✓ läuft    │ ✓ paket      │
│ AMD64 (64bit)│ ✓ läuft    │ ✓ läuft    │ ✓ paket      │
│ x86_64       │ ✓ läuft    │ ✓ läuft    │ ✓ paket      │
└──────────────┴────────────┴────────────┴──────────────┘
```

## Wichtige Gotchas

### 1. Binaries in subprocess
- ❌ FALSCH: `subprocess.run(["zpool", ...])` – setzt zpool im PATH voraus
- ✓ RICHTIG: Ist OK, wird z.B. `which zpool` zur Laufzeit geprüft
- Aber: Dokumentation muss erwähnen "ZFS Tools müssen installiert sein"

### 2. systemd Service
- Pi (Debian/Raspberry Pi OS): ✓ Hat systemd
- x86 (Ubuntu/Debian): ✓ Hat systemd
- AMD64 (CentOS/RHEL): ✓ Hat systemd
- Alpine Linux: ✗ Nutzt OpenRC (andere config nötig)

### 3. File Paths
- Pi: `/opt/zmb-webui/backend`
- x86/AMD64: Gleich OK

### 4. Package Manager
- Pi (Debian): `apt`
- Ubuntu: `apt`
- RHEL/CentOS: `dnf` / `yum`

## Deployment Instructions

### Für ARM64 Pi:
```bash
sudo bash backend/install.sh
# Autodetekt: Debian-based → apt
```

### Für x86/AMD64 (Debian/Ubuntu):
```bash
sudo bash backend/install.sh
# Autodetekt: Debian-based → apt
```

### Für x86/AMD64 (RHEL/CentOS):
```bash
# Manuell oder create backend/install-rhel.sh
```

## Zu tun vor Production

1. ✓ **Python Code:** Schon arch-agnostisch
2. ⚠️ **install.sh:** Muss `os-release` checken statt zu assumieren
3. ⚠️ **Systemd Service:** Optional: create RHEL variant
4. ⚠️ **Frontend Build:** Dokumentieren dass auf stärkerem System gebaut wird
5. ✓ **Dependencies:** Alle plattformübergreifend verfügbar

## Architektur-Check-Script

```bash
# vor Deployment checken:
#!/bin/bash
echo "Architecture: $(uname -m)"
echo "OS: $(lsb_release -ds)"
echo "Python: $(python3 --version)"
echo "ZFS: $(zpool list 2>/dev/null && echo 'installed' || echo 'NOT installed')"
echo "systemd: $(systemctl 2>/dev/null && echo 'yes' || echo 'no')"
```