# Installation et prérequis

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

## Télécharger et installer [#télécharger-et-installer]

Ouvrez [Télécharger](/download), choisissez votre système et votre architecture, puis suivez les étapes ci-dessous. Si une version n’est pas encore disponible, revenez plus tard ou [contactez l’assistance](/support).

## Windows [#windows]

1. Téléchargez l’installateur pour la cible Windows indiquée. Dans PowerShell, remplacez le nom fictif ci-dessous par le vrai nom téléchargé. Comparez l’empreinte affichée au SHA-256 publié. Arrêtez-vous en cas de différence.

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

2. Exécutez l’installateur vérifié en tant qu’utilisateur Windows prévu. Il installe une version du Client dans les données locales de cet utilisateur et ajoute un raccourci **SynthCrew Client** au menu Démarrer.
3. Démarrez **SynthCrew Client** depuis ce raccourci. Un lancement réussi ouvre l’espace Client ; connectez votre compte client uniquement lorsque l’accès est activé. Un test privé non signé ne prouve pas une signature publique ni une vérification sur machine vierge.

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

1. Choisissez l’archive correspondant à votre architecture. Remplacez le nom d’exemple ci-dessous par le vrai nom. Exécutez `sha256sum` et comparez le résultat au SHA-256 publié avant extraction ; arrêtez en cas de différence. La destination est un exemple de répertoire dédié appartenant à l’utilisateur.

```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. Depuis le répertoire décompressé, exécutez `python3 installer/linux_client.py`. Le lanceur vérifie l’inventaire et utilise un environnement officiel FreeCAD 1.1.4 compatible. Il peut réutiliser un environnement compatible ou télécharger et vérifier par somme de contrôle la version officielle épinglée par utilisateur. Pour choisir explicitement un environnement décompressé, ajoutez `--runtime` suivi de son chemin absolu.
3. Une première acquisition nécessite un accès réseau, `unsquashfs` de squashfs-tools avec prise en charge de zstd et jusqu’à 5 GiB libres. Installez ces outils via votre distribution si le lanceur le demande. Un bureau graphique et un Linux Secret Service fonctionnel avec `secret-tool` sont nécessaires pour le Client et la connexion sécurisée.
4. Un lancement réussi ouvre l’espace Client. Si un prérequis ou une vérification d’architecture ou d’intégrité échoue, lisez l’erreur, corrigez l’exigence indiquée et réessayez ; ne contournez pas la vérification. Si un répertoire temporaire FreeCAD incomplet est signalé, examinez-le puis supprimez uniquement ce répertoire partiel propre à la tâche avant de réessayer.

## Suppression [#suppression]

Sous Windows, utilisez l’entrée **Uninstall Client** versionnée du menu Démarrer ou l’entrée correspondante des applications installées. Sous Linux, ne supprimez le répertoire dédié décompressé qu’après fermeture. Préservez les projets et tout profil ou environnement encore nécessaire ; la suppression d’une version ne prouve pas que toute configuration préserve les données.

## Mise à jour sûre [#mise-à-jour-sûre]

Consultez la [page de disponibilité](/download) pour une nouvelle cible qualifiée et comparez sa révision et son empreinte avant installation. Gardez installation, profil et projets existants jusqu’au lancement du remplacement et à la vérification de votre travail. Ne considérez pas un artefact de test ou la qualification d’une autre plateforme comme une mise à jour de votre cible.

## Si la vérification échoue [#si-la-vérification-échoue]

Arrêtez-vous avant d’exécuter l’installateur. Confirmez plateforme et architecture et comparez à nouveau le fichier au SHA-256 publié. Sans empreinte qualifiée ou version publiée, il n’existe aucun téléchargement public à vérifier. Ne désactivez pas les contrôles d’intégrité et ne supprimez pas l’installation précédente pour forcer une mise à jour.