Chaotic's Nyx

Nix flake for "too much bleeding-edge" and unreleased packages (e.g., mesa_git, linux_cachyos, firefox_nightly, sway_git, gamescope_git). And experimental modules (e.g., HDR, duckdns).

From the Chaotic Linux User Group (LUG), the same one that maintains Chaotic-AUR! 🧑🏻‍💻

This is a fork of Chaotic-Nyx. I use Garnix CI to provide binary cache for selected packages. See the documentation page for the list of cached packages and usage instructions.

I bump packages daily. However, I don't use many of the applications myself. If you encounter any issues, please open an issue and I'll try to fix them.

The official source-code repository is available as "chaotic-cx/nyx" at GitHub.

For issues related to this fork, please open an issue on this repository's issues page.

• How to use it
  
  • On NixOS unstable
  • On NixOS stable
  • On Home-Manager
  • Running packages (without installing)
  • Binary Cache notes
• Lists of options and packages
• Notes
• Criteria for new packages
• Troubleshooting

How to use it

On NixOS unstable

This tutorial does not apply for users using NixOS 24.11 and other stable channels. This tutorial is for unstable users.

We recommend integrating this repo using Flakes:

# flake.nix
{
  description = "My configuration";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    nyx-loner.url = "github:lonerOrz/nyx-loner"; # IMPORTANT
  };

  outputs = { nixpkgs, nyx-loner, ... }: {
    nixosConfigurations = {
      hostname = nixpkgs.lib.nixosSystem { # Replace "hostname" with your system's hostname
        system = "x86_64-linux";
        modules = [
          ./configuration.nix
          nyx-loner.nixosModules.default # IMPORTANT
        ];
      };
    };
  };
}

In your configuration.nix enable the kernel you want:

# configuration.nix
{ pkgs, ... }:
{
  boot.kernelPackages = pkgs.linuxPackages_cachyos-lto;
  # or: pkgs.linuxPackages_cachyos-gcc
}

On NixOS stable

This tutorial is for NixOS stable versions (24.11, 25.05, etc.).

We recommend integrating this repo using Flakes:

# flake.nix
{
  description = "My configuration";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.11";
    nyx-loner.url = "github:lonerOrz/nyx-loner"; # IMPORTANT
  };

  outputs = { nixpkgs, nyx-loner, ... }: {
    nixosConfigurations = {
      hostname = nixpkgs.lib.nixosSystem { # Replace "hostname" with your system's hostname
        system = "x86_64-linux";
        modules = [
          ./configuration.nix
          nyx-loner.nixosModules.default # IMPORTANT
        ];
      };
    };
  };
}

In your configuration.nix enable the packages that you want:

# configuration.nix
{ pkgs, ... }:
{
  boot.kernelPackages = pkgs.linuxPackages_cachyos-lto;
}

On Home-Manager

This method is for home-manager setups without NixOS.

We recommend integrating this repo using Flakes:

# flake.nix
{
  description = "My configuration";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    nyx-loner.url = "github:lonerOrz/nyx-loner"; # IMPORTANT
    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { nixpkgs, nyx-loner, ... }: {
    homeConfigurations = {
      configName = home-manager.lib.homeManagerConfiguration {
        pkgs = nixpkgs.legacyPackages.x86_64-linux;
        modules = [
          ./home-manager/default.nix
          nyx-loner.homeManagerModules.default # IMPORTANT
        ];
      };
    };
  };
}

In your home-manager/default.nix add a nix.package, and enable the desired packages:

{ pkgs, ... }:
{
  nix.package = pkgs.nix;
  home.packages = [ pkgs.linux_cachyos-lto ];
}

Running packages (without installing)

Besides using our module/overlay, you can run packages (without installing them) using:

nix run github:lonerOrz/nyx-loner#linux_cachyos-lto

Binary Cache notes

This fork uses Garnix CI to provide binary cache for selected packages. The cache is automatically built and deployed for the following architectures:

• x86_64-linux

To use the cache, add the following to your configuration.nix:

     nix = {
      substituters = [
        "https://cache.garnix.io" # add garnix cache
      ];
      trusted-public-keys = [
        "cache.garnix.io:CTFPyKSLcx5RMJKfLo5EEPUObbA78b0YQ2DTCJXqr9g="
      ];
    };

Lists of options and packages

An always up-to-date list of all our options and packages is available at: the documentation page.

Notes

Branches

main branch is the primary target for contribution.

Upstream to nixpkgs

If you are interested in pushing any of these packages to the upstream nixpkgs, you have our blessing.

Suggestions

If you have any suggestion to enhance our packages, modules, or even the CI's codes, let us know through the GitHub repo's issues.

Troubleshooting

If you encounter any issues, please open an issue on the issues page.

Special Thanks

Special thanks to the original Chaotic-Nyx project and its contributors.