https://github.com/ryhkml/nix-home-manager
An alternative approach to replacing dotfiles
https://github.com/ryhkml/nix-home-manager
fish home-manager linux lua nix nixpkgs x86-64
Last synced: about 1 year ago
JSON representation
An alternative approach to replacing dotfiles
- Host: GitHub
- URL: https://github.com/ryhkml/nix-home-manager
- Owner: ryhkml
- License: unlicense
- Created: 2024-06-03T08:51:11.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-15T00:13:58.000Z (about 1 year ago)
- Last Synced: 2025-07-15T04:43:04.539Z (about 1 year ago)
- Topics: fish, home-manager, linux, lua, nix, nixpkgs, x86-64
- Language: Nix
- Homepage:
- Size: 182 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nix Home Manager
The nix home manager configuration i use is my never-ending journey to keep things smooth and fun.
## Installation
> [!NOTE]
>
> This is my personal best practice how to install Nix Home Manager on all Linux distributions, except immutable distributions.
>
> If you are using an immutable distribution, visit [here](https://github.com/DeterminateSystems/nix-installer).
1. Choose single-user installation, run:
```sh
sh <(curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install) --no-daemon
. /home/$USER/.nix-profile/etc/profile.d/nix.sh
```
For more information, visit [nixos.org/download](https://nixos.org/download/)
2. Add Home Manager channel, run:
```sh
nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --add https://github.com/nix-community/nixGL/archive/main.tar.gz nixgl
nix-channel --update
```
In the Nix ecosystem, which includes the Nix Home Manager, a channel refers to a method for managing and distributing collections of Nix packages and configurations.
Channels are essentially repositories of Nix expressions that define both packages and configurations. These channels are regularly updated, allowing users to subscribe to them to receive the latest updates.
The mentioned command adds a channel named "home-manager", indicating that any package installed through this channel will be updated to the latest version available, as per the unstable branch listed on [search.nixos.org/packages](https://search.nixos.org/packages). For the channel called “nixgl”, you can visit [here](https://github.com/nix-community/nixGL).
3. Run the Home Manager installation command and create the first Home Manager generation:
```sh
nix-shell '' -A install
echo ". /home/$USER/.nix-profile/etc/profile.d/nix.sh" | tee -a ~/.bashrc > /dev/null
source ~/.bashrc
```
4. Check home.nix configuration, run:
```sh
cat ~/.config/home-manager/home.nix
```
## Next Step
Visit [configuration example](https://nix-community.github.io/home-manager/index.xhtml#sec-usage-configuration), how to use `home-manager` command.
## Packages
The installed packages include command line interface, language server protocol, formatter, and some plugins of the package itself.
### A
1. [act](https://nektosact.com) - Run GitHub Actions locally
1. [air](https://github.com/air-verse/air) - Live reload for Go apps
1. [alacritty](https://alacritty.org) - A cross-platform OpenGL terminal emulator
1. [asciiquarium-transparent](https://github.com/nothub/asciiquarium) - Aquarium/sea animation in ASCII art
1. [asm-lsp](https://github.com/bergercookie/asm-lsp) - LSP fo Assembly
1. [asmfmt](https://github.com/klauspost/asmfmt) - Formatter fo Assembly
1. [astyle](https://astyle.sourceforge.net) - Formatter only for Java
### B
1. [bat](https://github.com/sharkdp/bat) - Alternative to `cat`
1. [bash-language-server](https://github.com/bash-lsp/bash-language-server) - LSP for Bash
1. [beautysh](https://github.com/lovesegfault/beautysh) - Formatter for Shell
1. [bun](https://bun.sh) - Javascript runtime, bundler, test runner, and package manager
1. [btop](https://github.com/aristocratos/btop) - A monitor of resources
### C
1. [cmus](https://cmus.github.io) - Console music player for Unix-like operating systems
1. [ctop](https://ctop.sh) - Top-like interface for container metrics
1. [curl](https://curl.se) - Tool and library to transfer data (with [c-ares](https://c-ares.org) and [gsasl](https://www.gnu.org/software/gsasl) features)
### D
1. [direnv](https://direnv.net) - Unclutter your .profile
1. [dockerfile-language-server-nodejs](https://github.com/rcjsuen/dockerfile-language-server) - LSP for Dockerfile
1. [duf](https://github.com/muesli/duf) - Disk usage or free utility. A better `df` alternative
### E
1. [editorconfig](https://editorconfig.org) - Enforces consistent coding styles across editors and IDEs
1. [exiftool](https://exiftool.org) - Meta information reader or writer
1. [eza](https://eza.rocks) - A modern alternative to `ls`
### F
1. [fastfetch](https://github.com/fastfetch-cli/fastfetch) - Neofetch like system information tool
1. [fd](https://github.com/sharkdp/fd) - Alternative to `find`
1. [file](https://darwinsys.com/file) - Shows the type of files
1. [firebase](https://firebase.google.com/docs/cli) - Firebase CLI
1. [fish](https://fishshell.com) - User friendly command line shell
1. [fishPlugins.autopair](https://github.com/jorgebucaran/autopair.fish) - Auto complete matching pairs in the fish command line
1. [fzf](https://github.com/junegunn/fzf) - Command line fuzzy finder
### G
1. [gcloud](https://cloud.google.com/sdk/docs/install) - Google Cloud CLI
1. [gnuplot](https://www.gnuplot.info) - Portable command line driven graphing utility for many platforms
1. [go](https://go.dev) - Golang!
1. [gopls](https://pkg.go.dev/golang.org/x/tools/gopls) - LSP for Go
### H
1. [hey](https://github.com/rakyll/hey) - HTTP load generator, ApacheBench (ab) replacement
1. [hyperfine](https://github.com/sharkdp/hyperfine) - Command line benchmarking tool
### I
1. [id3v2](https://id3v2.sourceforge.net) - Command line editor for id3v2 tags
### J
1. [java](https://openjdk.java.net) - Java Development Kit
1. [jdt-language-server](https://github.com/eclipse/eclipse.jdt.ls) - LSP for Java
1. [jq](https://jqlang.github.io/jq) - Lightweight and flexible command line JSON processor
### L
1. [lazydocker](https://github.com/jesseduffield/lazydocker) - The lazier way to manage everything docker
1. [lazygit](https://github.com/jesseduffield/lazygit) - Terminal UI for git commands
1. [lmstudio](https://lmstudio.ai) - Run local LLMs
1. [lua](https://www.lua.org) - Lualang!
### M
1. [minify](https://go.tacodewolff.nl/minify) - Web formats minifier
### N
1. [neovim](https://www.neovim.io) - Hyperextensible Vim-based text editor
1. [nginx-language-server](https://github.com/pappasam/nginx-language-server) - LSP for nginx.conf
1. [nil](https://github.com/oxalica/nil) - Yet another LSP for Nix
1. [nixgl](https://github.com/nix-community/nixGL) - A wrapper tool for Nix OpenGL application
1. [nix-prefetch-git](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/tools/package-management/nix-prefetch-scripts/default.nix) - Script used to obtain source hashes for fetchgit
1. [nixfmt-rfc-style](https://github.com/NixOS/nixfmt) - Formatter for Nix
1. [nodejs](https://nodejs.org/en) - Event-driven I/O framework for the V8 Javascript engine
1. [nodePackages.prettier](https://prettier.io) - Formatter only for HTML, CSS, JS, TS, and JSON
1. [nodePackages.vls](https://github.com/vuejs/vetur/tree/master/server) - LSP for Vue
1. [noisetorch](https://github.com/noisetorch/NoiseTorch) - Virtual microphone device with noise supression for PulseAudio
### P
1. [pnpm](https://pnpm.io) - Fast, disk space efficient package manager
1. [podman-compose](https://github.com/containers/podman-compose) - Implementation of docker-compose with podman backend
### R
1. [ripgrep](https://github.com/BurntSushi/ripgrep) - Searcher with the raw speed of grep
1. [rlwrap](https://github.com/hanslub42/rlwrap) - A readline wrapper
1. [rustup](https://www.rustup.rs) - Rust toolchain installer
1. [rust-analyzer](https://rust-analyzer.github.io) - Modular compiler frontend for the Rust language
1. [rustfmt](https://github.com/rust-lang-nursery/rustfmt) - Formatter for Rust
### S
1. [shellcheck](https://hackage.haskell.org/package/ShellCheck) - Shell script analysis tool
1. [speedtest-cli](https://github.com/sivel/speedtest-cli) - Testing internet bandwidth
1. [stylua](https://github.com/johnnymorganz/stylua) - Formatter for Lua
1. [sqlite](https://www.sqlite.org) - Small and fast SQL database engine
### T
1. [tokei](https://github.com/XAMPPRocky/tokei) - Count your code quickly
1. [trash-cli](https://github.com/andreafrancia/trash-cli) - Safety `rm` :)
1. [typescript](https://www.typescriptlang.org) - Javascript with syntax for types
1. [typescript-language-server](https://github.com/typescript-language-server/typescript-language-server) - LSP for Typescript using tsserver
### U
1. [unar](https://theunarchiver.com) - Archive unpacker program
### V
1. [vscode-langservers-extracted](https://github.com/hrsh7th/vscode-langservers-extracted) - LSP extracted from Vscode only for HTML/CSS/JSON/ESLint
1. [Vscodium](https://vscodium.com) - VSCode without MS branding, telemetry, or licensing
### Y
1. [yamlfmt](https://github.com/google/yamlfmt) - Formatter for YAML
1. [yaml-language-server](https://github.com/redhat-developer/yaml-language-server) - LSP for YAML
1. [yt-dlp](https://github.com/yt-dlp/yt-dlp) - Command line tool to download videos from Youtube and other sites
### Z
1. [zellij](https://zellij.dev) - A terminal workspace
1. [zig](https://ziglang.org) - Ziglang!
1. [zls](https://github.com/zigtools/zls) - LSP for Zig
1. [zoxide](https://github.com/ajeetdsouza/zoxide) - Fast `cd` that learns your habits
## Uninstalling Nix and Nix Home Manager (Single-User)
Just delete the files and directories containing nix and home-manager.
Since i have shell aliases `rm = trash-put`, i need to first perform a cleanup by running the command home-manager switch.
```sh
# Remove shell aliases rm = trash-put
home-manager switch
nix-collect-garbage -d
rm -rf ~/.cache/nix \
~/.config/nix ~/.config/home-manager \
~/.local/share/nix ~/.local/share/home-manager \
~/.local/state/nix ~/.local/state/home-manager
rm -rf /nix ~/.nix-channels ~/.nix-defexpr ~/.nix-profile
```
Finally, remove the installation script section from the `.bashrc` and `.bash_profile` files as well
```sh
# .bash_profile
if [ -e /home/user/.nix-profile/etc/profile.d/nix.sh ]; then . /home/user/.nix-profile/etc/profile.d/nix.sh; fi
# .bashrc
. "$HOME"/.nix-profile/etc/profile.d/nix.sh
```