Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ryoku.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
1. Download

Signed alpha builds are published at iso.ryoku.dev/stable/:
FileURL
ISOhttps://iso.ryoku.dev/stable/ryoku-<date>-x86_64-main.iso
Signaturehttps://iso.ryoku.dev/stable/ryoku-<date>-x86_64-main.iso.sig
SHA256https://iso.ryoku.dev/stable/ryoku-<date>-x86_64-main.iso.sha256
Public keyhttps://iso.ryoku.dev/stable/ryoku-release-key.pub.asc

​
2. Verify the signature

Releases are signed by Ryoku Releases <[email protected]>. Always check the imported key’s fingerprint matches before trusting it. If it does not, do not import. 
Fingerprint: 621F 579B D155 94C4 DE84  0B7D 5329 7813 C0BE E055
The canonical public key is also in the repo at keys/ryoku-release-key.pub.asc, bound to git history. Quick verify (replace <date> with the file you downloaded): 
# Import the release key
curl -sSL https://iso.ryoku.dev/stable/ryoku-release-key.pub.asc | gpg --import

# Confirm fingerprint matches the one above
gpg --fingerprint [email protected]

# Verify signature on the ISO
gpg --verify ryoku-<date>-x86_64-main.iso.sig ryoku-<date>-x86_64-main.iso

# Spot-check the SHA256
sha256sum -c ryoku-<date>-x86_64-main.iso.sha256
Full step-by-step verification — including a clean keyring path and the explicit “what good output looks like” — is in the release pipeline doc.

​
3. Create install media

Pick any of:
  • dd (Linux/macOS): sudo dd if=ryoku-<date>-x86_64-main.iso of=/dev/sdX bs=4M status=progress conv=fsync. Triple-check /dev/sdX matches your USB stick, not your system disk.
  • balenaEtcher: cross-platform GUI; pick the ISO, pick the drive, flash.
  • Ventoy: drop the ISO onto a Ventoy-formatted USB and boot. Lets you keep multiple ISOs on one stick.
USB stick should be at least 8 GB.

​
4. Try in a VM first (optional but encouraged)

Ryoku is alpha. Before committing to bare metal, boot the ISO in a VM (QEMU/KVM, VirtualBox, VMware) with at least 4 GB RAM and 30 GB disk to walk through the installer end to end.

​
5. Boot the installer

Boot the USB on the target machine. The ISO ships a guided install path:
  1. The live environment auto-launches the Ryoku Configurator, a front end to archinstall tuned for Ryoku defaults.
  2. You answer a short series of prompts: keyboard layout, locale, timezone, hostname, user, password, disk, partition scheme, filesystem.
  3. The Configurator hands off to archinstall, which lays down the base Arch system on the selected disk.
  4. When archinstall finishes, the Ryoku installer runs automatically: it pulls down the Ryoku package set, theming pipeline, and shell layer, configures SDDM, and stages the first-boot welcome.
  5. Reboot, eject the USB, and log in.

​
6. First boot

Continue to First boot for what to expect after you log in and where to click first.

​
Hardware notes

Ryoku targets NVIDIA, hybrid, AMD, and Apple Silicon. The working hardware list, driver matrix, and the harmless chroot warnings to ignore live in the ISO build recipe. Secure Boot support is on the roadmap, not automatic yet.