# Installation und Voraussetzungen

Canonical: https://synthcrew.io/de/docs/installation

## Herunterladen und installieren [#herunterladen-und-installieren]

Öffnen Sie [Download](/download), wählen Sie Betriebssystem und Architektur und folgen Sie den Schritten unten. Falls eine Version noch nicht verfügbar ist, schauen Sie später erneut nach oder [kontaktieren Sie den Support](/support).

## Windows [#windows]

1. Laden Sie den Installer für das angegebene Windows-Ziel herunter. Ersetzen Sie in PowerShell den Platzhalter unten durch den tatsächlichen Dateinamen. Vergleichen Sie den angezeigten Hash mit dem veröffentlichten SHA-256-Wert. Stoppen Sie bei Abweichung.

```powershell
Get-FileHash -Algorithm SHA256 -LiteralPath ".\REPLACE-WITH-INSTALLER.exe"
```

2. Führen Sie den geprüften Installer als vorgesehener Windows-Benutzer aus. Er installiert eine versionierte Client-Version in dessen lokalen App-Daten und fügt eine **SynthCrew Client**-Startmenüverknüpfung hinzu.
3. Starten Sie **SynthCrew Client** über die Verknüpfung. Ein erfolgreicher Start öffnet den Client-Arbeitsbereich; verbinden Sie Ihr Kundenkonto erst bei aktiviertem Zugang. Ein unsignierter privater Test belegt keine öffentliche Signierung oder Prüfung auf einem sauberen Rechner.

## Linux x86-64 and ARM64 [#linux-x86-64-and-arm64]

1. Wählen Sie das Archiv für Ihre Architektur. Ersetzen Sie den Beispieldateinamen unten durch den tatsächlichen. Führen Sie `sha256sum` aus und vergleichen Sie die Ausgabe vor dem Entpacken mit dem veröffentlichten SHA-256-Wert; stoppen Sie bei Abweichung. Das Ziel ist ein beispielhaftes dediziertes Benutzerverzeichnis.

```bash
sha256sum ./REPLACE-WITH-CLIENT-ARCHIVE.tar.zst
mkdir -p "$HOME/SynthCrew/preview"
tar --zstd -xf ./REPLACE-WITH-CLIENT-ARCHIVE.tar.zst -C "$HOME/SynthCrew/preview"
cd "$HOME/SynthCrew/preview"
python3 installer/linux_client.py
```

2. Führen Sie im entpackten Verzeichnis `python3 installer/linux_client.py` aus. Der Launcher prüft das Paketinventar und nutzt eine kompatible offizielle FreeCAD-1.1.4-Laufzeit. Er kann eine vorhandene kompatible Laufzeit wiederverwenden oder die festgelegte offizielle Laufzeit pro Benutzer herunterladen und per Prüfsumme prüfen. Zur expliziten Auswahl einer entpackten Laufzeit ergänzen Sie `--runtime` und deren absoluten Verzeichnispfad.
3. Der erste Bezug benötigt Netzwerkzugriff, `unsquashfs` aus squashfs-tools mit zstd-Unterstützung und bis zu 5 GiB freien Speicher. Installieren Sie diese Werkzeuge über Ihre Distribution, falls der Launcher sie anfordert. Für Client und sichere Anmeldung sind ein grafischer Desktop und ein funktionierender Linux Secret Service mit `secret-tool` nötig.
4. Ein erfolgreicher Start öffnet den Client-Arbeitsbereich. Schlägt eine Voraussetzung, Architektur- oder Integritätsprüfung fehl, lesen Sie den Fehler, beheben Sie die genannte Anforderung und versuchen Sie es erneut; umgehen Sie die Prüfung nicht. Wird ein unvollständiges FreeCAD-Stagingverzeichnis gemeldet, prüfen Sie es zuerst und entfernen Sie vor dem erneuten Versuch nur dieses aufgabeneigene Teilverzeichnis.

## Entfernung [#entfernung]

Verwenden Sie unter Windows den versionierten Startmenüeintrag **Uninstall Client** oder den entsprechenden Eintrag installierter Apps. Entfernen Sie unter Linux das dedizierte entpackte Verzeichnis erst nach dem Schließen. Bewahren Sie benötigte Projektdateien, Profile und Laufzeiten auf; die Entfernung einer Version beweist keine Datenerhaltung bei jeder Hostkonfiguration.

## Sicher aktualisieren [#sicher-aktualisieren]

Prüfen Sie die [Verfügbarkeitsseite](/download) auf ein neues qualifiziertes Ziel und vergleichen Sie Revision und Hash vor der Installation. Behalten Sie bestehende Installation, Profil und Projekte, bis der Ersatz gestartet und Ihre Arbeit geprüft ist. Ein Testartefakt oder die Qualifizierung einer anderen Plattform ist kein Update für Ihr Ziel.

## Bei fehlgeschlagener Prüfung [#bei-fehlgeschlagener-prüfung]

Stoppen Sie vor Ausführung des Installers. Bestätigen Sie Plattform und Architektur und vergleichen Sie die heruntergeladene Datei erneut mit dem veröffentlichten SHA-256-Wert. Ohne veröffentlichten qualifizierten Hash oder Version gibt es keinen öffentlichen Download zur Prüfung. Deaktivieren Sie keine Integritätsprüfungen und löschen Sie die frühere Installation nicht, um ein Update zu erzwingen.