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

# Instalacja

> Pobierz obraz TsukineOS i uruchom system (x86_64 ISO / ARM64 IMG)

# Instalacja (uruchamianie z obrazu)

TsukineOS **nie posiada graficznego instalatora**; dostarczane są gotowe obrazy: `.iso` dla x86\_64 i `.img` dla ARM64.

## Pobieranie obrazu

Przejdź do GitHub Releases, aby pobrać najnowszą wersję (obecnie **Infdev-0.2.4**):

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

| Architektura | Plik                               | Zastosowanie                                              |
| ------------ | ---------------------------------- | --------------------------------------------------------- |
| x86\_64      | `tsukineos-infdev0.2.4-x86_64.iso` | Fizyczna maszyna / QEMU / Ventoy                          |
| ARM64        | `tsukineos-infdev0.2.4-arm64.img`  | Urządzenia ARM takie jak Raspberry Pi (zapis na kartę SD) |

## x86\_64: trzy sposoby uruchomienia

**1. QEMU (zalecane do testów, najbardziej stabilne)**

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

**2. Pendrive z Ventoy**

Skopiuj plik ISO do partycji Ventoy i uruchom komputer z menu Ventoy.

**3. Bezpośredni zapis na dysk (ostrożnie)**

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

> `sdX` to litera docelowego dysku; błędny wybór usunie wszystkie dane z dysku.

## ARM64: zapis na kartę SD

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

Po zapisaniu włóż kartę do urządzenia typu Raspberry Pi i uruchom je.

## Wymagania systemowe

| Element            | Minimum                | Zalecane                                                         |
| ------------------ | ---------------------- | ---------------------------------------------------------------- |
| Procesor           | x86\_64 lub ARM64      | x86\_64                                                          |
| Pamięć RAM         | 512 MB                 | 2 GB                                                             |
| Przestrzeń dyskowa | wystarczająca na obraz | 16 GB lub więcej                                                 |
| Inne               | —                      | Niskolatencyjne urządzenie audio (do użycia po wprowadzeniu GUI) |

<Note>
  Ta strona została przetłumaczona przez AI i może zawierać nieścisłości. Wersja w chińskim uproszczonym jest wersją miarodajną.
</Note>

***

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