4
0
Fork
You've already forked iso
0
🎛️ | Xinux'es final ISO builder using org. provided abstractions [maintainer=@bahrom04] https://xinux.uz/download
  • Nix 100%
Uzinfocom Asssistant c1c23c144c flake.lock: Update
Flake lock file updates:
• Updated input 'nixpkgs':
 'git+https://git.oss.uzinfocom.uz/xinux/nixpkgs?ref=nixos-unstable&rev=0bb7ec54c8483066ec9d7720e780a5caa71f8612&shallow=1' (2026年07月08日)
 → 'git+https://git.oss.uzinfocom.uz/xinux/nixpkgs?ref=nixos-unstable&rev=e7a3ca8092b61ff85b6a45bf863ea2b2d6a661b3&shallow=1' (2026年07月11日)
• Updated input 'xinux-modules':
 'git+https://git.oss.uzinfocom.uz/xinux/modules?ref=main&rev=fd90ba6a5a67b9afcb84bfddc5cccdbbd7f78e15' (2026年07月11日)
 → 'git+https://git.oss.uzinfocom.uz/xinux/modules?ref=main&rev=94b6537e5597609c9937b236f0f972dd02c648af' (2026年07月12日)
• Updated input 'xinux-modules/cachyos-kernel':
 'git+https://git.oss.uzinfocom.uz/mirrors/nix-cachyos-kernel?ref=master&rev=4673c8f6d48baf2ec3f14b6a9f8c4ecfb0810d6f&shallow=1' (2026年07月10日)
 → 'git+https://git.oss.uzinfocom.uz/mirrors/nix-cachyos-kernel?ref=master&rev=6472f543b68e0b874603ad944419747815cfeb7a&shallow=1' (2026年07月11日)
• Updated input 'xinux-modules/cachyos-kernel/nixpkgs':
 'github:NixOS/nixpkgs/dc29ee8fa098c86053cc8ef25594738f28be5b6b?narHash=sha256-ll8SjCNgwWuou5Q64GMjuUrrqRJW1gy3uCMjd%2Boa9KA%3D' (2026年07月10日)
 → 'github:NixOS/nixpkgs/bbb4df715cb62e53cd329090c2b69eb07f2bddac?narHash=sha256-PEXS6z/zIvH%2BO7J3Ua3N2OUE7IvMhhghwtKxZhVfm5U%3D' (2026年07月11日)
• Updated input 'xinux-modules/zen-browser':
 'git+https://git.oss.uzinfocom.uz/mirrors/zen-browser-flake?ref=refs/heads/main&rev=71e156423dae9496d7fd9e89029a1a82516fb9d8&shallow=1' (2026年07月10日)
 → 'git+https://git.oss.uzinfocom.uz/mirrors/zen-browser-flake?ref=refs/heads/main&rev=51602966429e8ccae61324e56b51c37308d1b64e&shallow=1' (2026年07月12日)
2026年07月13日 00:01:04 +00:00
.forgejo/workflows ci: setup update locker for new release 2026年07月08日 19:03:44 +05:00
checks update xinux modules hash 2026年07月08日 16:26:17 +05:00
modules/nixos chore: add vm base name till now 2026年07月09日 19:41:57 +05:00
packages remove not existed variant 2026年07月09日 18:42:50 +05:00
shells/iso fix: folder convention 2026年05月25日 22:38:20 +05:00
systems chore(modules): enable libreoffice to test install size behaviour 2026年07月07日 00:34:53 +05:00
.envrc chore: added xserver and updated flake.lock 2025年09月22日 19:01:54 +05:00
.gitignore chore: added xserver and updated flake.lock 2025年09月22日 19:01:54 +05:00
flake.lock flake.lock: Update 2026年07月13日 00:01:04 +00:00
flake.nix chore(hydra): disable other build variants 2026年07月10日 11:39:18 +05:00
LICENSE chore: Update LICENSE to gpl3 2025年10月31日 12:15:15 +05:00
NIXPKGSLICENSE chore: remove badges 2025年03月02日 13:42:34 +05:00
README.md docs: add default password 2026年05月24日 15:08:21 +09:00

Xinux ISO

Xinux is a NixOS based Linux distribution focused on beginner friendliness and ease of use. This repository contains the configuration used to build the Xinux ISO files.

Documentation

This repo uses nixos-generators project.

How to build iso

  1. Clone this repository and navigate to the project directory
  2. nixos-rebuild build-image --image-variant iso-installer --flake .#xinux --show-trace
  3. The resulting ISO file will be linked in result/iso/xinux-<version>.iso

Other builds (on NixOS hosts)

# aarch64-linux
nixos-rebuild build-image --image-variant iso-installer --flake .#xinux-arm --show-trace
# aarch64-linux SD card image
# No installer, the default user/password is `xinux` (change after the first boot)
nixos-rebuild build-image --image-variant sd-card --flake .#xinux-pi --show-trace
# Virtualbox
nixos-rebuild build-image --image-variant virtualbox --flake .#xinux --show-trace
# Vm
nixos-rebuild build-vm --flake .#xinux --show-trace
# VMWARE
nixos-rebuild build-image --image-variant vmware --flake .#xinux --show-trace
# Offline install coming soon...
# nix build .#install-isoCnfigurations.xinux-offline.config.system.build.images.iso

Building on non-NixOS hosts (Ubuntu, Debian, etc.)

nixos-rebuild ships only with NixOS. On other Linux distributions, install the Nix package manager and use nix build against the same flake attributes.

One-time setup

Pick one of the two Nix installers below.

  1. Determinate Systems installer (flakes enabled by default):

    curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
    
  2. nixos.org installer (flakes must be enabled manually):

    sh <(curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install) --daemon
    # Enable flakes and the nix command
    sudo mkdir -p /etc/nix
    echo 'experimental-features = nix-command flakes' | sudo tee -a /etc/nix/nix.conf
    sudo systemctl restart nix-daemon
    

Optional: enable aarch64 emulation for cross-arch builds on an x86_64 host

sudo apt install qemu-user-static binfmt-support
echo 'extra-platforms = aarch64-linux' | sudo tee -a /etc/nix/nix.conf
sudo systemctl restart nix-daemon

Build commands

# ISO installer (x86_64)
nix build .#nixosConfigurations.xinux.config.system.build.images.iso-installer --show-trace
# aarch64-linux
nix build .#nixosConfigurations.xinux-arm.config.system.build.images.iso-installer --show-trace
# aarch64-linux SD card image
# No installer, the default user/password is `xinux` (change after the first boot)
nix build .#nixosConfigurations.xinux-pi.config.system.build.images.sd-card --show-trace
# VirtualBox
nix build .#nixosConfigurations.xinux.config.system.build.images.virtualbox --show-trace
# VMware
nix build .#nixosConfigurations.xinux.config.system.build.images.vmware --show-trace

Hardware requirements

Note

Only 64-bit processors are supported.

Xinux ISO (x86_64 and AArch64)

Minimum Recommended
RAM 8 GB 16 GB
Storage 128 GB 256 GB

Xinux Pi

The kernel-reserved CMA pool (256 MiB, placed inside the low 1 GiB DMA zone) and the GNOME desktop rule out sub-2 GB boards. Supported Raspberry Pi models:

Model RAM
Pi 4 2 GB+
Pi 5 4 GB+
CM4 2 GB+

Development

Add a unique iso name on system/ARCHITECTURE/HOSTNAME otherwise the build command gets the first match.