> ## 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 이미지를 받아 부팅하기(x86_64 ISO / ARM64 IMG)

# 설치(이미지 부팅)

TsukineOS는 현재 **그래픽 설치 프로그램이 없으며**, 완성된 이미지를 제공합니다. x86\_64는 `.iso`를, ARM64는 `.img`를 사용합니다.

## 이미지 받기

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`  | Raspberry Pi 등 ARM 장치(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. Ventoy USB**

ISO를 Ventoy 파티션에 넣고, 부팅 시 Ventoy 메뉴에서 해당 ISO를 선택하세요.

**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
```

기록이 완료되면 Raspberry Pi류 장치에 삽입하여 부팅하세요.

## 시스템 요구 사항

| 항목  | 최소               | 권장                      |
| --- | ---------------- | ----------------------- |
| CPU | x86\_64 또는 ARM64 | x86\_64                 |
| 메모리 | 512 MB           | 2 GB                    |
| 저장소 | 이미지를 담을 수 있을 만큼  | 16 GB 이상                |
| 기타  | —                | 저지연 오디오 장치(GUI 준비 후 사용) |

<Note>
  이 페이지는 AI가 번역하였으며 부정확한 내용이 포함될 수 있습니다. 간체 중국어 원본을 기준으로 합니다.
</Note>

***

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