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

# Instalação

> Obtenha a imagem do TsukineOS e inicialize (ISO x86_64 / IMG ARM64)

# Instalação (inicialização a partir da imagem)

O TsukineOS **não possui instalador gráfico** no momento. São fornecidas imagens prontas: `.iso` para x86\_64 e `.img` para ARM64.

## Obter a imagem

Acesse o GitHub Releases para baixar a versão mais recente (atualmente **Infdev-0.2.4**):

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

| Arquitetura | Arquivo                            | Uso                                                        |
| ----------- | ---------------------------------- | ---------------------------------------------------------- |
| x86\_64     | `tsukineos-infdev0.2.4-x86_64.iso` | Máquina física / QEMU / Ventoy                             |
| ARM64       | `tsukineos-infdev0.2.4-arm64.img`  | Dispositivos ARM como Raspberry Pi (gravação em cartão SD) |

## x86\_64: três formas de inicializar

**1. QEMU (recomendado para testes, mais estável)**

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

**2. Pendrive com Ventoy**

Coloque a ISO na partição do Ventoy e inicialize a partir do menu do Ventoy.

**3. Gravação direta em máquina real (com cautela)**

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

> `sdX` é a letra do disco de destino. Um erro apagará todos os dados do disco.

## ARM64: gravar em cartão SD

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

Após a gravação, insira o cartão no dispositivo tipo Raspberry Pi e inicialize.

## Requisitos do sistema

| Item          | Mínimo                   | Recomendado                                                               |
| ------------- | ------------------------ | ------------------------------------------------------------------------- |
| CPU           | x86\_64 ou ARM64         | x86\_64                                                                   |
| Memória       | 512 MB                   | 2 GB                                                                      |
| Armazenamento | Suficiente para a imagem | 16 GB ou mais                                                             |
| Outros        | —                        | Dispositivo de áudio de baixa latência (para uso após a GUI estar pronta) |

<Note>
  Esta página foi traduzida por IA e pode conter imprecisões. A versão em chinês simplificado é a autoritativa.
</Note>

***

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