Skip to content
catppuccin/nix

Stable Nix

When using stable Nix, we have a couple options for installing catppuccin/nix:

With npins

Section titled “With npins”

npins provides a way to easily “pin” and update external dependencies for your configurations.

Assuming you have followed their getting started guide, you can run the following:

Terminal window
npins add --name catppuccin github catppuccin nix

And in your system configuration:

let
  sources = import ./npins;
in
{
  imports = [
    (sources.catppuccin + "/modules/nixos")
  ];


  # if you use home-manager
  home-manager.users.pepperjack = {
    imports = [
      (sources.catppuccin + "/modules/home-manager")
    ];
  };
}

or if you use a standalone installation of home-manager

let
  sources = import ./npins.nix;
in
{
  imports = [
    (sources.catppuccin + "/modules/home-manager")
  ];


  home.username = "pepperjack";
  programs.home-manager.enable = true;
}

With channels

Section titled “With channels”

Nix channels provide a way for you to easily download, update, and use our modules — though at the cost of reproducible across machines.

To add catppuccin/nix as a channel, you can run the following:

Terminal window
sudo nix-channel --add https://github.com/catppuccin/nix/archive/main.tar.gz catppuccin
sudo nix-channel --update

And in your system configuration:

{
  imports = [
    <catppuccin/modules/nixos>
  ];


  # if you use home-manager
  home-manager.users.pepperjack = {
    imports = [
      <catppuccin/modules/home-manager>
    ];
  };
}

or if you use a standalone installation of home-manager

{
  imports = [
    <catppuccin/modules/home-manager>
  ];


  home.username = "pepperjack";
  programs.home-manager.enable = true;
}