Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CachyOS Home Manager setup

User environment for an x86_64 CachyOS/Arch workstation. Nix manages shell tools, desktop applications, configuration and user services. The host supplies drivers, the compositor, login services and system packages. Development tools use a shared writable mise installation.

Install

Start from CachyOS KDE with a normal desktop user. Run as that user:

curl -fsSL https://raw.githubusercontent.com/PluxelJS/nix-config/main/bootstrap/install.sh | bash

The installer installs Git if needed, clones into ~/.config/nix, then runs setup. An existing clean checkout is fast-forwarded; a checkout with local edits is used without pulling. Setup installs host dependencies and switches Home Manager. Sudo authentication is required for host changes.

From an existing checkout:

./setup --check              # preview
./setup                      # install or reconcile the desktop
./setup --flatpaks            # install deferred desktop Flatpaks and Code Studio
./setup --verify              # validate the active profile

Log out and back in after group membership changes. Reboot after installing kernel modules. Set your machine-local Git identity before creating commits:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

See bootstrap options and the software inventory for what gets installed.

Maintain

nixup                       # fetch published config and apply committed locks
nixup --check               # preview published changes
nixup --home                # update config and switch Home Manager only
nixup --latest              # refresh Nix inputs/assets, then switch
nixup --local               # apply this workspace, including untracked files

Updating modes require a clean, non-diverged checkout. --local accepts local edits. Nix, host packages, Flatpaks and mise have separate update commands; see operations.

Profiles and local settings

Profile Flake output Defaults
Desktop current Shell, GUI, fonts, portals, Flatpak integration, development services
Shell current-shell Shell and fonts
Container current-container Shell
./setup --profile shell
home-manager switch --flake ~/.config/nix#current-shell --impure

Portable outputs read USER and HOME, so direct Nix commands need --impure. The optional ~/.config/ahdg/home.nix is loaded for the current account:

{ ... }:
{
  ahdg.extraFeatures = [ ];
  ahdg.disabledFeatures = [ "fastfetch" ];
}

Defaults live in profiles.json; feature options and their dependencies are declared in profile.nix. Resolved settings are written under ~/.config/ahdg/ for the maintenance tools. Git identity, credentials, databases and application history stay in the user's home.

Find the right file

Task Source
Change Nix inputs or exported outputs flake.nix
Change package/resource pins sources.json, update-sources.py
Change profiles or default features profiles.json
Change host/AUR/Flatpak application selection cachyos.toml
Change shell behavior shell modules, zsh snippets
Change desktop integration GUI modules
Change native application config or first-run seeds home/files
Change bootstrap logic Go source, bootstrap notes

Guides

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages