- 1. Preface
- 2. Introduction to Home Manager
- 3. Installing Home Manager
❱
- 3.1. Standalone installation
- 3.2. NixOS module
- 3.3. nix-darwin module
- 4. Using Home Manager
❱
- 4.1. Configuration Example
- 4.2. Rollbacks
- 4.3. Keeping your ~ safe from harm
- 4.4. Graphical services
- 4.5. GPU on non-NixOS systems
- 4.6. Modular Services
- 4.7. Updating
- 4.8. Upgrading to a new Home Manager release
- 5. Nix Flakes
❱
- 5.1. Prerequisites
- 5.2. Standalone setup
- 5.3. NixOS module
- 5.4. nix-darwin module
- 5.5. flake-parts module
- 6. Writing Home Manager Modules
❱
- 6.1. Option Types
- 7. Contributing
❱
- 7.1. Getting started
- 7.2. Guidelines
- 7.3. Release Notes
- 7.4. News
- 7.5. Tests
- 8. Home Manager Internals
❱
- 8.1. Activation
- 9. Third-Party Tools and Extensions
❱
- 9.1. Module Collections
- 10. Frequently Asked Questions (FAQ)
❱
- 10.1. Why is there a collision error when switching generation?
- 10.2. Why are the session variables not set?
- 10.3. How to set up a configuration for multiple users/machines?
- 10.4. Why do I get an error message about ca.desrt.dconf or dconf.service?
- 10.5. How do I install packages from Nixpkgs unstable?
- 10.6. How do I change the package used by a module?
- 11. Options
❱
- 11.1. Home Manager Configuration Options
❱
- 11.1.1. _module
- 11.1.2. accounts
- 11.1.3. dbus
- 11.1.4. dconf
- 11.1.5. editorconfig
- 11.1.6. fonts
- 11.1.7. gtk
- 11.1.8. home
- 11.1.9. i18n
- 11.1.10. launchd
- 11.1.11. lib
- 11.1.12. manual
- 11.1.13. meta
- 11.1.14. news
- 11.1.15. nix
- 11.1.16. nixpkgs
- 11.1.17. pam
- 11.1.18. programs
❱
- 11.1.18.1. abaddon
- 11.1.18.2. abook
- 11.1.18.3. acd-cli
- 11.1.18.4. aerc
- 11.1.18.5. aerospace
- 11.1.18.6. afew
- 11.1.18.7. ahoviewer
- 11.1.18.8. aiac
- 11.1.18.9. aichat
- 11.1.18.10. aider-chat
- 11.1.18.11. airlift
- 11.1.18.12. alacritty
- 11.1.18.13. algia
- 11.1.18.14. aliae
- 11.1.18.15. alistral
- 11.1.18.16. alot
- 11.1.18.17. am2rlauncher
- 11.1.18.18. amber
- 11.1.18.19. amfora
- 11.1.18.20. amoco
- 11.1.18.21. amp
- 11.1.18.22. andcli
- 11.1.18.23. animdl
- 11.1.18.24. anime-downloader
- 11.1.18.25. anki
- 11.1.18.26. antigravity
- 11.1.18.27. antigravity-cli
- 11.1.18.28. anup
- 11.1.18.29. anvil-editor
- 11.1.18.30. anyrun
- 11.1.18.31. aperture
- 11.1.18.32. aphorme
- 11.1.18.33. aria2
- 11.1.18.34. aria2p
- 11.1.18.35. asciinema
- 11.1.18.36. ashell
- 11.1.18.37. astroid
- 11.1.18.38. atool
- 11.1.18.39. attic-client
- 11.1.18.40. atuin
- 11.1.18.41. autojump
- 11.1.18.42. autorandr
- 11.1.18.43. awscli
- 11.1.18.44. bacon
- 11.1.18.45. bash
- 11.1.18.46. bashmount
- 11.1.18.47. bat
- 11.1.18.48. beets
- 11.1.18.49. bemenu
- 11.1.18.50. bluetuith
- 11.1.18.51. borgmatic
- 11.1.18.52. bottom
- 11.1.18.53. boxxy
- 11.1.18.54. brave
- 11.1.18.55. broot
- 11.1.18.56. browserpass
- 11.1.18.57. btop
- 11.1.18.58. bun
- 11.1.18.59. calibre
- 11.1.18.60. carapace
- 11.1.18.61. cargo
- 11.1.18.62. cava
- 11.1.18.63. cavalier
- 11.1.18.64. chawan
- 11.1.18.65. chromium
- 11.1.18.66. claude-code
- 11.1.18.67. clock-rs
- 11.1.18.68. cmus
- 11.1.18.69. codex
- 11.1.18.70. command-not-found
- 11.1.18.71. comodoro
- 11.1.18.72. cudatext
- 11.1.18.73. cursor
- 11.1.18.74. darcs
- 11.1.18.75. dbeaver
- 11.1.18.76. delta
- 11.1.18.77. desktoppr
- 11.1.18.78. devenv
- 11.1.18.79. diff-highlight
- 11.1.18.80. diff-so-fancy
- 11.1.18.81. difftastic
- 11.1.18.82. dircolors
- 11.1.18.83. direnv
- 11.1.18.84. discocss
- 11.1.18.85. discord
- 11.1.18.86. distrobox
- 11.1.18.87. docker-cli
- 11.1.18.88. earthly
- 11.1.18.89. ec
- 11.1.18.90. eclipse
- 11.1.18.91. element-desktop
- 11.1.18.92. emacs
- 11.1.18.93. equibop
- 11.1.18.94. eww
- 11.1.18.95. eza
- 11.1.18.96. fabric-ai
- 11.1.18.97. fastfetch
- 11.1.18.98. fd
- 11.1.18.99. feedr
- 11.1.18.100. feh
- 11.1.18.101. firefox
- 11.1.18.102. firefoxpwa
- 11.1.18.103. fish
- 11.1.18.104. flashspace
- 11.1.18.105. floorp
- 11.1.18.106. foliate
- 11.1.18.107. foot
- 11.1.18.108. formiko
- 11.1.18.109. freetube
- 11.1.18.110. fresh-editor
- 11.1.18.111. fuzzel
- 11.1.18.112. fzf
- 11.1.18.113. gallery-dl
- 11.1.18.114. gcc
- 11.1.18.115. gh
- 11.1.18.116. gh-dash
- 11.1.18.117. ghostty
- 11.1.18.118. git
- 11.1.18.119. git-cliff
- 11.1.18.120. git-credential-keepassxc
- 11.1.18.121. git-credential-oauth
- 11.1.18.122. git-worktree-switcher
- 11.1.18.123. github-copilot-cli
- 11.1.18.124. gitui
- 11.1.18.125. gnome-shell
- 11.1.18.126. gnome-terminal
- 11.1.18.127. go
- 11.1.18.128. google-chrome
- 11.1.18.129. google-chrome-beta
- 11.1.18.130. google-chrome-dev
- 11.1.18.131. goto
- 11.1.18.132. gpg
- 11.1.18.133. gradle
- 11.1.18.134. granted
- 11.1.18.135. grep
- 11.1.18.136. grype
- 11.1.18.137. gurk-rs
- 11.1.18.138. halloy
- 11.1.18.139. havoc
- 11.1.18.140. helix
- 11.1.18.141. herdr
- 11.1.18.142. hexchat
- 11.1.18.143. himalaya
- 11.1.18.144. home-manager
- 11.1.18.145. hstr
- 11.1.18.146. htop
- 11.1.18.147. hwatch
- 11.1.18.148. hyfetch
- 11.1.18.149. hyprland-qt-support
- 11.1.18.150. hyprlock
- 11.1.18.151. hyprpanel
- 11.1.18.152. hyprshot
- 11.1.18.153. i3bar-river
- 11.1.18.154. i3blocks
- 11.1.18.155. i3status
- 11.1.18.156. i3status-rust
- 11.1.18.157. iamb
- 11.1.18.158. imv
- 11.1.18.159. infat
- 11.1.18.160. info
- 11.1.18.161. inori
- 11.1.18.162. intelli-shell
- 11.1.18.163. ion
- 11.1.18.164. irssi
- 11.1.18.165. java
- 11.1.18.166. jetbrains-remote
- 11.1.18.167. jjui
- 11.1.18.168. joplin-desktop
- 11.1.18.169. joshuto
- 11.1.18.170. jq
- 11.1.18.171. jqp
- 11.1.18.172. jrnl
- 11.1.18.173. jujutsu
- 11.1.18.174. k9s
- 11.1.18.175. kakoune
- 11.1.18.176. keepassxc
- 11.1.18.177. keychain
- 11.1.18.178. khal
- 11.1.18.179. khard
- 11.1.18.180. kickoff
- 11.1.18.181. kiro
- 11.1.18.182. kiro-cli
- 11.1.18.183. kitty
- 11.1.18.184. kodi
- 11.1.18.185. kraftkit
- 11.1.18.186. kubecolor
- 11.1.18.187. kubeswitch
- 11.1.18.188. lapce
- 11.1.18.189. lazydocker
- 11.1.18.190. lazygit
- 11.1.18.191. lazysql
- 11.1.18.192. lazyworktree
- 11.1.18.193. ledger
- 11.1.18.194. less
- 11.1.18.195. lesspipe
- 11.1.18.196. lf
- 11.1.18.197. librewolf
- 11.1.18.198. lieer
- 11.1.18.199. looking-glass-client
- 11.1.18.200. lsd
- 11.1.18.201. lutris
- 11.1.18.202. macchina
- 11.1.18.203. macos-terminal
- 11.1.18.204. man
- 11.1.18.205. mangohud
- 11.1.18.206. matplotlib
- 11.1.18.207. mbsync
- 11.1.18.208. mc
- 11.1.18.209. mcfly
- 11.1.18.210. mcp
- 11.1.18.211. meli
- 11.1.18.212. mercurial
- 11.1.18.213. mergiraf
- 11.1.18.214. micro
- 11.1.18.215. microsoft-edge
- 11.1.18.216. mise
- 11.1.18.217. mistral-vibe
- 11.1.18.218. mods
- 11.1.18.219. mpv
- 11.1.18.220. mpvpaper
- 11.1.18.221. mr
- 11.1.18.222. msmtp
- 11.1.18.223. mu
- 11.1.18.224. mujmap
- 11.1.18.225. mullvad-vpn
- 11.1.18.226. mypy
- 11.1.18.227. navi
- 11.1.18.228. ncmpcpp
- 11.1.18.229. ncspot
- 11.1.18.230. ne
- 11.1.18.231. neomutt
- 11.1.18.232. neovide
- 11.1.18.233. neovim
- 11.1.18.234. newsboat
- 11.1.18.235. nh
- 11.1.18.236. nheko
- 11.1.18.237. nix-index
- 11.1.18.238. nix-init
- 11.1.18.239. nix-search-tv
- 11.1.18.240. nix-your-shell
- 11.1.18.241. nnn
- 11.1.18.242. nom
- 11.1.18.243. noti
- 11.1.18.244. notmuch
- 11.1.18.245. npm
- 11.1.18.246. numbat
- 11.1.18.247. nushell
- 11.1.18.248. nvchecker
- 11.1.18.249. nyxt
- 11.1.18.250. obs-studio
- 11.1.18.251. obsidian
- 11.1.18.252. offlineimap
- 11.1.18.253. oh-my-posh
- 11.1.18.254. onagre
- 11.1.18.255. onedrive
- 11.1.18.256. onlyoffice
- 11.1.18.257. opam
- 11.1.18.258. opencode
- 11.1.18.259. openstackclient
- 11.1.18.260. opkssh
- 11.1.18.261. pandoc
- 11.1.18.262. papis
- 11.1.18.263. parallel
- 11.1.18.264. password-store
- 11.1.18.265. patdiff
- 11.1.18.266. pay-respects
- 11.1.18.267. pazi
- 11.1.18.268. pet
- 11.1.18.269. pgcli
- 11.1.18.270. pi-coding-agent
- 11.1.18.271. pianobar
- 11.1.18.272. pidgin
- 11.1.18.273. pimsync
- 11.1.18.274. pistol
- 11.1.18.275. piston-cli
- 11.1.18.276. pls
- 11.1.18.277. poetry
- 11.1.18.278. posting
- 11.1.18.279. powerline-go
- 11.1.18.280. pqiv
- 11.1.18.281. prismlauncher
- 11.1.18.282. ptyxis
- 11.1.18.283. pubs
- 11.1.18.284. pyenv
- 11.1.18.285. pylint
- 11.1.18.286. pyradio
- 11.1.18.287. pywal
- 11.1.18.288. qalculate
- 11.1.18.289. qcal
- 11.1.18.290. quickshell
- 11.1.18.291. qutebrowser
- 11.1.18.292. radicle
- 11.1.18.293. radio-active
- 11.1.18.294. radio-cli
- 11.1.18.295. ranger
- 11.1.18.296. rbenv
- 11.1.18.297. rbw
- 11.1.18.298. rclone
- 11.1.18.299. readline
- 11.1.18.300. rectangle
- 11.1.18.301. retext
- 11.1.18.302. retroarch
- 11.1.18.303. riff
- 11.1.18.304. rio
- 11.1.18.305. ripgrep
- 11.1.18.306. ripgrep-all
- 11.1.18.307. rizin
- 11.1.18.308. rmpc
- 11.1.18.309. rofi
- 11.1.18.310. rtorrent
- 11.1.18.311. ruff
- 11.1.18.312. sagemath
- 11.1.18.313. sapling
- 11.1.18.314. satty
- 11.1.18.315. sbt
- 11.1.18.316. scmpuff
- 11.1.18.317. screen
- 11.1.18.318. script-directory
- 11.1.18.319. senpai
- 11.1.18.320. sesh
- 11.1.18.321. sftpman
- 11.1.18.322. sheldon
- 11.1.18.323. sherlock
- 11.1.18.324. sioyek
- 11.1.18.325. sketchybar
- 11.1.18.326. skim
- 11.1.18.327. sm64ex
- 11.1.18.328. smug
- 11.1.18.329. spotify-player
- 11.1.18.330. sqls
- 11.1.18.331. ssh
- 11.1.18.332. starship
- 11.1.18.333. streamlink
- 11.1.18.334. superfile
- 11.1.18.335. swappy
- 11.1.18.336. sway-easyfocus
- 11.1.18.337. swayimg
- 11.1.18.338. swaylock
- 11.1.18.339. swayr
- 11.1.18.340. t3code
- 11.1.18.341. taskwarrior
- 11.1.18.342. tealdeer
- 11.1.18.343. television
- 11.1.18.344. terminator
- 11.1.18.345. termite
- 11.1.18.346. tex-fmt
- 11.1.18.347. texlive
- 11.1.18.348. thunderbird
- 11.1.18.349. timidity
- 11.1.18.350. tint2
- 11.1.18.351. tiny
- 11.1.18.352. tirith
- 11.1.18.353. tmate
- 11.1.18.354. tmux
- 11.1.18.355. todoman
- 11.1.18.356. tofi
- 11.1.18.357. topgrade
- 11.1.18.358. translate-shell
- 11.1.18.359. tray-tui
- 11.1.18.360. trippy
- 11.1.18.361. ttyper
- 11.1.18.362. twitch-tui
- 11.1.18.363. ty
- 11.1.18.364. urxvt
- 11.1.18.365. uv
- 11.1.18.366. vdirsyncer
- 11.1.18.367. vesktop
- 11.1.18.368. vicinae
- 11.1.18.369. vifm
- 11.1.18.370. vim
- 11.1.18.371. vim-vint
- 11.1.18.372. vinegar
- 11.1.18.373. visidata
- 11.1.18.374. vivaldi
- 11.1.18.375. vivid
- 11.1.18.376. vscode
- 11.1.18.377. vscodium
- 11.1.18.378. w3m
- 11.1.18.379. wallust
- 11.1.18.380. watson
- 11.1.18.381. waveterm
- 11.1.18.382. waybar
- 11.1.18.383. waylogout
- 11.1.18.384. wayprompt
- 11.1.18.385. wezterm
- 11.1.18.386. windsurf
- 11.1.18.387. wleave
- 11.1.18.388. wlogout
- 11.1.18.389. wofi
- 11.1.18.390. workstyle
- 11.1.18.391. xmobar
- 11.1.18.392. xplr
- 11.1.18.393. yambar
- 11.1.18.394. yarn
- 11.1.18.395. yazi
- 11.1.18.396. yofi
- 11.1.18.397. yt-dlp
- 11.1.18.398. z-lua
- 11.1.18.399. zapzap
- 11.1.18.400. zathura
- 11.1.18.401. zed-editor
- 11.1.18.402. zellij
- 11.1.18.403. zk
- 11.1.18.404. zoxide
- 11.1.18.405. zsh
- 11.1.19. qt
- 11.1.20. services
❱
- 11.1.20.1. activitywatch
- 11.1.20.2. amberol
- 11.1.20.3. arrpc
- 11.1.20.4. autorandr
- 11.1.20.5. autotiling
- 11.1.20.6. avizo
- 11.1.20.7. awww
- 11.1.20.8. batsignal
- 11.1.20.9. betterlockscreen
- 11.1.20.10. blanket
- 11.1.20.11. blueman-applet
- 11.1.20.12. borgmatic
- 11.1.20.13. cachix-agent
- 11.1.20.14. caffeine
- 11.1.20.15. cbatticon
- 11.1.20.16. clipcat
- 11.1.20.17. cliphist
- 11.1.20.18. clipman
- 11.1.20.19. clipmenu
- 11.1.20.20. clipse
- 11.1.20.21. colima
- 11.1.20.22. comodoro
- 11.1.20.23. conky
- 11.1.20.24. copyq
- 11.1.20.25. darkman
- 11.1.20.26. davmail
- 11.1.20.27. devilspie2
- 11.1.20.28. dropbox
- 11.1.20.29. dunst
- 11.1.20.30. dwm-status
- 11.1.20.31. easyeffects
- 11.1.20.32. elephant
- 11.1.20.33. emacs
- 11.1.20.34. espanso
- 11.1.20.35. etesync-dav
- 11.1.20.36. exo
- 11.1.20.37. flameshot
- 11.1.20.38. fluidsynth
- 11.1.20.39. fnott
- 11.1.20.40. fusuma
- 11.1.20.41. gammastep
- 11.1.20.42. getmail
- 11.1.20.43. git-sync
- 11.1.20.44. glance
- 11.1.20.45. gnome-keyring
- 11.1.20.46. gpg-agent
- 11.1.20.47. grobi
- 11.1.20.48. gromit-mpx
- 11.1.20.49. home-manager
- 11.1.20.50. hound
- 11.1.20.51. hypridle
- 11.1.20.52. hyprlauncher
- 11.1.20.53. hyprpaper
- 11.1.20.54. hyprpolkitagent
- 11.1.20.55. hyprshell
- 11.1.20.56. hyprsunset
- 11.1.20.57. imapnotify
- 11.1.20.58. jankyborders
- 11.1.20.59. jellyfin-mpv-shim
- 11.1.20.60. kanshi
- 11.1.20.61. kbfs
- 11.1.20.62. kdeconnect
- 11.1.20.63. keybase
- 11.1.20.64. keynav
- 11.1.20.65. librespot
- 11.1.20.66. lieer
- 11.1.20.67. linux-wallpaperengine
- 11.1.20.68. listenbrainz-mpd
- 11.1.20.69. local-ai
- 11.1.20.70. lorri
- 11.1.20.71. ludusavi
- 11.1.20.72. lxqt-policykit-agent
- 11.1.20.73. macos-remap-keys
- 11.1.20.74. mako
- 11.1.20.75. mbsync
- 11.1.20.76. megasync
- 11.1.20.77. mopidy
- 11.1.20.78. mpd
- 11.1.20.79. mpd-discord-rpc
- 11.1.20.80. mpd-mpris
- 11.1.20.81. mpdris2
- 11.1.20.82. mpdris2-rs
- 11.1.20.83. mpdscribble
- 11.1.20.84. mpris-proxy
- 11.1.20.85. muchsync
- 11.1.20.86. network-manager-applet
- 11.1.20.87. nextcloud-client
- 11.1.20.88. notify-osd
- 11.1.20.89. nvibrant
- 11.1.20.90. ollama
- 11.1.20.91. opensnitch-ui
- 11.1.20.92. osmscout-server
- 11.1.20.93. owncloud-client
- 11.1.20.94. pantalaimon
- 11.1.20.95. parcellite
- 11.1.20.96. pass-secret-service
- 11.1.20.97. pasystray
- 11.1.20.98. pbgopy
- 11.1.20.99. picom
- 11.1.20.100. pimsync
- 11.1.20.101. pipewire
- 11.1.20.102. pizauth
- 11.1.20.103. plan9port
- 11.1.20.104. playerctld
- 11.1.20.105. plex-mpv-shim
- 11.1.20.106. podman
- 11.1.20.107. polkit-gnome
- 11.1.20.108. polybar
- 11.1.20.109. poweralertd
- 11.1.20.110. proton-pass-agent
- 11.1.20.111. protonmail-bridge
- 11.1.20.112. psd
- 11.1.20.113. pueue
- 11.1.20.114. pulseeffects
- 11.1.20.115. radicle
- 11.1.20.116. random-background
- 11.1.20.117. recoll
- 11.1.20.118. redshift
- 11.1.20.119. remmina
- 11.1.20.120. rescrobbled
- 11.1.20.121. restic
- 11.1.20.122. rsibreak
- 11.1.20.123. safeeyes
- 11.1.20.124. screen-locker
- 11.1.20.125. sctd
- 11.1.20.126. shikane
- 11.1.20.127. shpool
- 11.1.20.128. signaturepdf
- 11.1.20.129. skhd
- 11.1.20.130. snixembed
- 11.1.20.131. spotifyd
- 11.1.20.132. ssh-agent
- 11.1.20.133. ssh-tpm-agent
- 11.1.20.134. stalonetray
- 11.1.20.135. status-notifier-watcher
- 11.1.20.136. swayidle
- 11.1.20.137. swaync
- 11.1.20.138. swayosd
- 11.1.20.139. sxhkd
- 11.1.20.140. syncthing
- 11.1.20.141. syshud
- 11.1.20.142. systembus-notify
- 11.1.20.143. taffybar
- 11.1.20.144. tahoe-lafs
- 11.1.20.145. tailscale-systray
- 11.1.20.146. taskwarrior-sync
- 11.1.20.147. tldr-update
- 11.1.20.148. tomat
- 11.1.20.149. trayer
- 11.1.20.150. trayscale
- 11.1.20.151. twmn
- 11.1.20.152. udiskie
- 11.1.20.153. unclutter
- 11.1.20.154. unison
- 11.1.20.155. vdirsyncer
- 11.1.20.156. volnoti
- 11.1.20.157. voxtype
- 11.1.20.158. walker
- 11.1.20.159. way-displays
- 11.1.20.160. wayle
- 11.1.20.161. wayvnc
- 11.1.20.162. wl-clip-persist
- 11.1.20.163. wlsunset
- 11.1.20.164. wluma
- 11.1.20.165. wob
- 11.1.20.166. wpaperd
- 11.1.20.167. xcape
- 11.1.20.168. xembed-sni-proxy
- 11.1.20.169. xidlehook
- 11.1.20.170. xscreensaver
- 11.1.20.171. xsettingsd
- 11.1.20.172. xsuspender
- 11.1.20.173. yubikey-agent
- 11.1.21. specialisation
- 11.1.22. sshAuthSock
- 11.1.23. systemd
- 11.1.24. targets
- 11.1.25. uninstall
- 11.1.26. vdirsyncer
- 11.1.27. wayland
- 11.1.28. xdg
- 11.1.29. xfconf
- 11.1.30. xresources
- 11.1.31. xsession
- 11.2. NixOS Configuration Options
❱
- 11.2.1. home-manager
- 11.3. nix-darwin Configuration Options
❱
- 11.3.1. home-manager
- 12. Release Notes
❱
- 12.1. Release 26.11
- 12.2. Release 26.05
- 12.3. Release 25.11
- 12.4. Release 25.05
- 12.5. Release 24.11
- 12.6. Release 24.05
- 12.7. Release 23.11
- 12.8. Release 23.05
- 12.9. Release 22.11
- 12.10. Release 22.05
- 12.11. Release 21.11
- 12.12. Release 21.05
- 12.13. Release 20.09
- 12.14. Release 20.03
- 12.15. Release 19.09
- 12.16. Release 19.03
- 12.17. Release 18.09