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

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)

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)

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

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)

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

⌘I

Getting Started

Tools & Commands

Build Guide

Project

Install TsukineOS from an Image

Installation (Image Boot)

Get the Image

x86_64: Three Ways to Boot

ARM64: Flash to SD Card

System Requirements

​Installation (Image Boot)

​Get the Image

​x86_64: Three Ways to Boot

​ARM64: Flash to SD Card

​System Requirements

Installation (Image Boot)

Get the Image

x86_64: Three Ways to Boot

ARM64: Flash to SD Card

System Requirements