# IMVEE Satellite Agent - Release v0.4.1

Release date: 2026-09-21 (Re-Publish mit vollständigem 5-Platform-Set; Tag v0.4.1 vom 2026-07-12)

## Wichtiger Hinweis

**Dieses Release ist die minimale Version für ein funktionierendes Enrollment.**
Versionen ≤ v0.3.x verwenden das alte `/ingest/register`-Protokoll, das vom SOCSuite-BFF
nicht mehr akzeptiert wird (401). Neue/rebuildete VMs brechen mit v0.1.0/v0.3.x bei der
Enrollment ab. → v0.4.1 enthält das aktuelle `/ingest/enroll`-Protokoll.

## Installation

### Quick Install (Empfohlen)

```bash
# Linux/macOS — Version wird automatisch via 'latest' aufgelöst
curl -fsSL https://downloads.dev.imvee.de/satellite/latest/remote-install.sh | \
  sudo bash -s -- --token=YOUR_TOKEN

# Oder Version explizit pinnen:
curl -fsSL https://downloads.dev.imvee.de/satellite/latest/remote-install.sh | \
  sudo bash -s -- --token=YOUR_TOKEN --version=v0.4.1
```

### Windows

```powershell
Invoke-WebRequest -Uri "https://downloads.dev.imvee.de/satellite/latest/imvee-satellite-agent-windows-amd64.exe" -OutFile "imvee-satellite.exe"
$env:IMVEE_ENROLLMENT_TOKEN = "YOUR_TOKEN"
.\imvee-satellite.exe install-service
Start-Service IMVEESatellite
```

### Manuelle Installation

Binaries (dieses Verzeichnis):

- `imvee-satellite-agent-linux-amd64`
- `imvee-satellite-agent-linux-arm64`
- `imvee-satellite-agent-darwin-amd64`
- `imvee-satellite-agent-darwin-arm64`
- `imvee-satellite-agent-windows-amd64.exe`

## Changes in 0.4.1

### Fixed
- **`shell_commands`-Collector startete nie** (`cmd/agent/main.go`): `startShellCollector()`
  / `isShellCollectionEnabled()` (Netlink Proc Connector + `/proc`-Polling-Fallback, ECS-Events)
  waren implementiert, aber im Dispatch-Block von `onConfigUpdate` nicht verdrahtet.
  `logs_sent_1h` blieb dauerhaft `0`. Dispatch-Block nach Docker-Vorbild ergänzt.

## Checksums (SHA-256)

Siehe `checksums.txt` (verifizieren: `sha256sum -c checksums.txt`).