# Instalación y requisitos

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

## Descargar e instalar [#descargar-e-instalar]

Abre [Descargar](/download), elige tu sistema y arquitectura y sigue los pasos siguientes. Si una versión aún no está disponible, vuelve más tarde o [contacta con soporte](/support).

## Windows [#windows]

1. Descarga el instalador para el destino Windows indicado. En PowerShell, sustituye el nombre provisional por el nombre real descargado. Compara el hash mostrado con el SHA-256 publicado. Detente si difieren.

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

2. Ejecuta el instalador verificado como el usuario de Windows previsto. Instala una versión del Client en los datos locales de ese usuario y añade un acceso directo **SynthCrew Client** al menú Inicio.
3. Inicia **SynthCrew Client** desde el acceso directo. Un inicio correcto abre el espacio del Client; conecta tu cuenta de cliente solo cuando se habilite el acceso. Una prueba privada sin firmar no demuestra firma pública ni verificación en una máquina limpia.

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

1. Elige el archivo para tu arquitectura. Sustituye el nombre de ejemplo por el real. Ejecuta `sha256sum` y compara el resultado con el SHA-256 publicado antes de extraer; detente si difieren. El destino es un ejemplo de directorio dedicado propiedad del usuario.

```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. Desde el directorio extraído ejecuta `python3 installer/linux_client.py`. El lanzador verifica el inventario del paquete y usa un entorno oficial FreeCAD 1.1.4 compatible. Puede reutilizar uno compatible existente o descargar y verificar por suma de comprobación el entorno oficial fijado por usuario. Para seleccionar explícitamente un entorno extraído, añade `--runtime` seguido de la ruta absoluta de su directorio.
3. La primera adquisición necesita acceso a la red, `unsquashfs` de squashfs-tools con soporte zstd y hasta 5 GiB libres. Instala esas herramientas mediante tu distribución si el lanzador lo solicita. Se necesitan un escritorio gráfico y un Linux Secret Service funcional con `secret-tool` para el Client y el acceso seguro.
4. Un inicio correcto abre el espacio del Client. Si falla un requisito o una comprobación de arquitectura o integridad, lee el error, corrige el requisito indicado y reintenta; no eludas la verificación. Si se indica un directorio temporal FreeCAD incompleto, examínalo primero y elimina solo ese directorio parcial de la tarea antes de reintentar.

## Eliminación [#eliminación]

En Windows usa la entrada versionada **Uninstall Client** del menú Inicio o la entrada correspondiente de aplicaciones instaladas. En Linux elimina el directorio dedicado extraído solo tras cerrarlo. Conserva los proyectos y cualquier perfil o entorno que aún necesites; eliminar una versión no demuestra que todas las configuraciones del equipo conserven todos los datos.

## Actualizar con seguridad [#actualizar-con-seguridad]

Consulta la [página de disponibilidad](/download) para una nueva versión cualificada y compara su revisión y hash antes de instalar. Conserva instalación, perfil y proyectos existentes hasta que el reemplazo arranque y hayas comprobado tu trabajo. No consideres un artefacto de prueba o la cualificación de otra plataforma como actualización para tu destino.

## Si falla la verificación [#si-falla-la-verificación]

Detente antes de ejecutar el instalador. Confirma plataforma y arquitectura y vuelve a comparar el archivo descargado con el SHA-256 publicado. Si no hay hash cualificado ni versión publicados, no hay descarga pública que verificar. No desactives comprobaciones de integridad ni borres la instalación anterior para forzar una actualización.