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.
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 | bashThe 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 profileLog 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.
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 filesUpdating modes require a clean, non-diverged checkout. --local accepts local
edits. Nix, host packages, Flatpaks and mise have separate update commands;
see operations.
| 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 --impurePortable 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.
| 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 |
- Software: purpose, installation source, configuration and updates.
- Operations: updates, switches, verification, recovery and backups.
- Bootstrap: fresh install and host repair.
- Ownership: enforced config, first-run defaults and local state.
- Reproducibility: locks, downloads and rollback limits.
- Themes: fonts, light/dark mode and DMS colors.
- IDE integration: Code Studio, JetBrains and shared tools.
- Git authentication: OAuth, wallet and GitHub CLI.
- Shell shortcuts, shortcut policy.
- Optional n2n console: EasyN2N-compatible LAN connection setup.