> ## 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.

# Installazione di TsukineOS: avvia ISO o IMG

> Ottieni l'immagine di TsukineOS e avvia il sistema (ISO x86_64 / IMG ARM64).

# Installazione (avvio da immagine)

TsukineOS **non dispone di un installatore grafico**: viene fornito come immagine finita. Per x86\_64 si usa un file `.iso`, per ARM64 un file `.img`.

## Ottieni l'immagine

Vai su GitHub Releases per scaricare l'ultima versione (attualmente **Infdev-0.2.4**):

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

| Architettura | File                               | Utilizzo                                                         |
| ------------ | ---------------------------------- | ---------------------------------------------------------------- |
| x86\_64      | `tsukineos-infdev0.2.4-x86_64.iso` | Macchina fisica / QEMU / Ventoy                                  |
| ARM64        | `tsukineos-infdev0.2.4-arm64.img`  | Dispositivi ARM come Raspberry Pi (masterizzazione su scheda SD) |

## x86\_64: tre modalità di avvio

**1. QEMU (consigliato per i primi test, il più stabile)**

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

**2. Chiavetta USB con Ventoy**

Copia l'ISO nella partizione Ventoy, poi avvia dal menu Ventoy all'accensione.

**3. Scrittura diretta su disco fisico (con cautela)**

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

> `sdX` è la lettera del disco di destinazione: se sbagliata, cancellerà l'intero disco.

## ARM64: masterizzazione su scheda SD

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

Al termine della scrittura, inserisci la scheda SD nel dispositivo Raspberry Pi e accendilo.

## Requisiti di sistema

| Elemento      | Minimo                               | Consigliato                                                                 |
| ------------- | ------------------------------------ | --------------------------------------------------------------------------- |
| CPU           | x86\_64 o ARM64                      | x86\_64                                                                     |
| Memoria       | 512 MB                               | 2 GB                                                                        |
| Archiviazione | sufficiente per contenere l'immagine | 16 GB o superiore                                                           |
| Altro         | —                                    | dispositivo audio a bassa latenza (da utilizzare quando la GUI sarà pronta) |

<Note>
  Questa pagina è stata tradotta dall'IA e potrebbe contenere imprecisioni. Fa fede la versione in cinese semplificato.
</Note>

***

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