> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tsukineos.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation de TsukineOS

> Obtenir et démarrer les images TsukineOS (ISO x86_64 / IMG ARM64)

# Installation (démarrage depuis l'image)

TsukineOS ne dispose actuellement **pas d'installateur graphique**. Les images fournies sont des systèmes complets : x86\_64 utilise un fichier `.iso`, ARM64 un fichier `.img`.

## Télécharger l'image

Rendez-vous sur GitHub Releases pour télécharger la dernière version (actuellement **Infdev-0.2.4**) :

[https://github.com/tsutokiteo/TsukineOS/releases](https://github.com/tsutokiteo/TsukineOS/releases)

| Architecture | Fichier                            | Utilisation                                              |
| ------------ | ---------------------------------- | -------------------------------------------------------- |
| x86\_64      | `tsukineos-infdev0.2.4-x86_64.iso` | Machine physique / QEMU / Ventoy                         |
| ARM64        | `tsukineos-infdev0.2.4-arm64.img`  | Appareils ARM comme le Raspberry Pi (flash sur carte SD) |

## x86\_64 : trois méthodes de démarrage

**1. QEMU (recommandé pour les tests, le plus stable)**

```bash theme={null}
qemu-system-x86_64 -m 2048 \
  -cdrom tsukineos-infdev0.2.4-x86_64.iso -boot d
```

**2. Clé USB Ventoy**

Placez l'ISO dans la partition Ventoy, puis démarrez depuis le menu Ventoy.

**3. Écriture directe sur disque (à utiliser avec prudence)**

```bash theme={null}
sudo dd if=tsukineos-infdev0.2.4-x86_64.iso of=/dev/sdX bs=4M status=progress
```

> `sdX` est le disque cible. Une erreur de cible effacera l'intégralité du disque.

## ARM64 : flash sur carte SD

```bash theme={null}
xzcat tsukineos-infdev0.2.4-arm64.img.xz | sudo dd of=/dev/mmcblk0 bs=4M status=progress
```

Une fois l'écriture terminée, insérez la carte SD dans l'appareil (Raspberry Pi ou similaire) et démarrez.

## Configuration requise

| Élément    | Minimum                | Recommandé                                                                                 |
| ---------- | ---------------------- | ------------------------------------------------------------------------------------------ |
| Processeur | x86\_64 ou ARM64       | x86\_64                                                                                    |
| Mémoire    | 512 Mo                 | 2 Go                                                                                       |
| Stockage   | Suffisant pour l'image | 16 Go ou plus                                                                              |
| Autre      | —                      | Périphérique audio à faible latence (à utiliser une fois l'interface graphique disponible) |

<Note>
  Cette page a été traduite par IA et peut contenir des inexactitudes. La version en chinois simplifié fait foi.
</Note>

***

© 2024-2026 TsutokiTeo/JunweiZhang. All rights reserved.
