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

> Отримайте образ TsukineOS і запустіть його (ISO для x86_64 / IMG для ARM64)

# Встановлення (запуск образу)

TsukineOS наразі **не має графічного інсталятора**; замість цього пропонуються готові образи: `.iso` для x86\_64 та `.img` для ARM64.

## Отримання образу

Перейдіть на сторінку GitHub Releases, щоб завантажити останню версію (поточна — **Infdev-0.2.4**):

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

| Архітектура | Файл                               | Призначення                                        |
| ----------- | ---------------------------------- | -------------------------------------------------- |
| x86\_64     | `tsukineos-infdev0.2.4-x86_64.iso` | Фізична машина / QEMU / Ventoy                     |
| ARM64       | `tsukineos-infdev0.2.4-arm64.img`  | ARM-пристрої типу Raspberry Pi (запис на SD-карту) |

## x86\_64: три способи запуску

**1. QEMU (рекомендується спочатку спробувати, найстабільніший)**

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

**2. Завантажувальний USB Ventoy**

Помістіть ISO у розділ Ventoy і виберіть його з меню під час завантаження.

**3. Прямий запис на фізичний диск (з обережністю)**

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

> `sdX` — це цільовий диск; помилка у виборі призведе до повного очищення диска.

## ARM64: запис на SD-карту

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

Після завершення запису вставте SD-карту в пристрій типу Raspberry Pi і вмикніть його.

## Системні вимоги

| Компонент          | Мінімум              | Рекомендовано                                                         |
| ------------------ | -------------------- | --------------------------------------------------------------------- |
| Процесор           | x86\_64 або ARM64    | x86\_64                                                               |
| Оперативна пам'ять | 512 МБ               | 2 ГБ                                                                  |
| Сховище            | Достатньо для образу | 16 ГБ або більше                                                      |
| Інше               | —                    | Аудіопристрій із низькою затримкою (для використання після появи GUI) |

<Note>
  Цю сторінку перекладено штучним інтелектом, тому вона може містити неточності. Авторитетним є варіант спрощеною китайською.
</Note>

***

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