BUILD 0.60.1-BETA.19

For the sake of power and beauty.

RYOKU NIXOS

The Ryoku desktop, rebuilt as a declarative NixOS system.

SCROLL
01 // WHAT IT IS

Same identity.
Different foundation.

Ryoku on NixOS keeps the shell, motion, theming and desktop language intact, while the system underneath becomes reproducible, generational and declarative.

01

Ryoku still feels like Ryoku.

Hyprland, Ryoku Shell, Hub, launcher, theming, lockscreen and the desktop interaction model stay cohesive. Nix changes the implementation — not the identity.

  • Normal NixOS generations
  • Flake-based delivery
  • Rollback capable
  • User-owned overrides remain separate
02 // SHOWCASE

One consistent
design

Not a theme pack. Not a screenshot collection. One visual system across launcher, overview, settings, media, store and extensions.

03 // RYOSTORE

Make it yours
without making it a mess.

RyoStore turns Ryoku customization into a browsable surface — themes, lock screens, Fastfetch designs, plugins and visual extras without scattering manual files across the system.

THEMESFASTFETCHLOCKSCREENSPLUGINS
04 // RASHIN

Local context.
Inside the desktop.

Rashin gives the shell a local system-aware layer designed to understand the machine it lives on. It belongs beside the rest of Ryoku rather than floating in a disconnected browser tab.

LOCALSYSTEM AWAREOPTIONAL
05 // INSTALL

Three steps in.
No Nix wizardry required.

Fresh NixOS is enough. Ryoku installs on top of your existing system and leaves your bootloader, disks, kernel and graphics configuration under your control.

01Enable flakes

Add this inside /etc/nixos/configuration.nix.

nix.settings.experimental-features = [
  "nix-command"
  "flakes"
];
sudo nixos-rebuild switch
03Install Ryoku

Preview the installer first if you want to see exactly what changes.

nix run github:aethctl/Ryoku-on-NixOS/main#install -- --dry-run

Then install:

nix run github:aethctl/Ryoku-on-NixOS/main#install
00 → 07
STEP-BY-STEP INSTALL GUIDE

Fresh NixOS → Ryoku. Nothing skipped.

For first-time NixOS users: every file, command, save step, rebuild, dry run and recovery point explained in order.

OPEN GUIDE ↗
SAFE BY DESIGN

The installer builds before switching and stores affected configuration backups under /var/backups/ryoku-nixos/.

06 // FAQ

Common questions.
Short answers.

01How do I enable flakes?+

Add this to /etc/nixos/configuration.nix:

nix.settings.experimental-features = [
  "nix-command"
  "flakes"
];

Then run sudo nixos-rebuild switch.

02What should a beginner flake.nix look like?+
{
  description = "My NixOS system";

  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-26.05";

  outputs = { nixpkgs, ... }: {
    nixosConfigurations.nixos = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [ ./configuration.nix ];
    };
  };
}

Rebuild with sudo nixos-rebuild switch --flake /etc/nixos#nixos.

03How do I update Ryoku?+
ryoku update

That's it. Ryoku advances its configured flake input, builds a new NixOS generation and switches to it.

04Does Ryoku replace NixOS?+

No. Ryoku integrates into your existing NixOS configuration. Your bootloader, kernel, disks and hardware-specific graphics setup remain owned by your host configuration.

05What if an update breaks?+

Ryoku updates create normal NixOS generations, so previous generations remain available through standard NixOS rollback and boot-menu mechanisms.

ACTIVE PORT
07 // HONEST STATUS

This is a living port.

Ryoku develops quickly. NixOS sometimes needs different packaging and integration than Arch, so releases can land slightly later while the Nix-specific work is tested.

Current
0.60.1-beta.19
Channel
Beta
Platform
NixOS
Upstream
Ryoku

FOR THE SAKE OF
POWER AND BEAUTY.

RYOKU // NIXOS