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

# Install TsukineOS from an Image

> Download and boot the TsukineOS image (x86_64 ISO / ARM64 IMG).

# Installation (Image Boot)

TsukineOS currently **does not have a graphical installer**. It provides ready-made images: `.iso` for x86\_64 and `.img` for ARM64.

## Get the Image

Download the latest release from GitHub Releases (currently **Infdev-0.2.4**):

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

| Architecture | File                               | Purpose                                            |
| ------------ | ---------------------------------- | -------------------------------------------------- |
| x86\_64      | `tsukineos-infdev0.2.4-x86_64.iso` | Physical machine / QEMU / Ventoy                   |
| ARM64        | `tsukineos-infdev0.2.4-arm64.img`  | Raspberry Pi and other ARM devices (SD card flash) |

## x86\_64: Three Ways to Boot

**1. QEMU (Recommended for first try, most stable)**

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

**2. Ventoy USB Drive**

Copy the ISO into the Ventoy partition and select it from the Ventoy boot menu.

**3. Direct Write to Disk (Use with Caution)**

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

> `sdX` is the target disk identifier. Writing to the wrong disk will erase all data on it.

## ARM64: Flash to SD Card

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

After flashing, insert the SD card into a Raspberry Pi-like device and power it on.

## System Requirements

| Item    | Minimum                  | Recommended                                           |
| ------- | ------------------------ | ----------------------------------------------------- |
| CPU     | x86\_64 or ARM64         | x86\_64                                               |
| Memory  | 512 MB                   | 2 GB                                                  |
| Storage | Enough to hold the image | 16 GB or more                                         |
| Other   | —                        | Low-latency audio device (for use after GUI is ready) |

<Note>
  This page was translated by AI and may contain inaccuracies. The Simplified Chinese version is authoritative.
</Note>

***

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