Personal Gentoo Linux dotfiles managed with chezmoi.
# Bootstrap chezmoi and apply dotfiles
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply Saulimedes/dotfilesYou'll be prompted once for your name and email (used for git/jj config, kept out of this repo).
This will:
- Install chezmoi
- Clone dotfiles
- Run atomic setup scripts (overlays, packages, flatpak, etc.)
- Apply all configuration files
Gentoo packages (packages.txt):
- Shells: zsh, starship, atuin, zoxide
- CLI tools: bat, eza, fd, ripgrep, fzf
- Network: nmap, mtr, tcpdump, iperf
- Media: mpv, ffmpeg
- Browsers: Brave, Helium
- Messaging: Telegram, Session
mise (dot_config/mise/config.toml):
- Languages: Node, Python, Go, Rust, Zig, Java, Bun, Deno
- Kubernetes: kubectl, helm, k9s, stern, kustomize, k3s
- IaC/Cloud: OpenTofu, Vault, Ansible, gcloud, azure-cli
- Dev tools: direnv, gh, jq, yq, shellcheck, shfmt
| Script | Purpose |
|---|---|
run_once_setup-portage.sh |
Enable Gentoo overlays (guru, another-brave-overlay, pentoo) |
run_once_setup-flatpak.sh |
Configure Flathub, install Flatpak apps |
run_once_install-packages.sh |
Install packages from packages.txt |
run_once_install-antidote.sh |
Install zsh plugin manager |
run_once_install_tmux_plugins |
Install TPM and plugins |
run_once_install-mpv-plugins.sh |
Install mpv scripts/shaders (mpv360, gif-generator, webm) |
run_once_setup-podman.sh |
Configure rootless podman (subuid/subgid, docker symlink) |
run_once_setup-xkb-udev-rule.sh |
udev rule to re-apply the XKB patch on keyboard hotplug |
run_onchange_mise-install |
Install mise tools |
run_onchange_install-packages.sh |
Re-installs packages when packages.txt changes |
run_onchange_setup-openrc-services.sh |
Enable OpenRC services (chronyd, tlp, bluetooth, mullvad-daemon, i2pd, autofs, syncthing) |
run_onchange_setup-samba-mounts.sh |
Configure autofs mounts to the Unraid NAS |
run_onchange_sync-genkernel.sh.tmpl |
Sync genkernel.conf to /etc/genkernel.conf |
run_onchange_sync-useflags.sh.tmpl |
Sync useflags.txt to /etc/portage/package.use/ |
run_onchange_after_tangle-emacs-config.sh.tmpl |
Tangle the Emacs org files into ~/.emacs.d/lisp/ when they change |
- Zsh with antidote plugin manager
- Starship prompt
- Atuin shell history
- forgit for fzf + git integration
- Custom abbreviations and functions
- US QWERTY with
altgr-weurvariant for Western European characters ;key remapped todead_diaeresisvia XKB — type;afor ä,;ofor ö,;sfor ẞ;;for literal semicolon,;(space) preserves natural typing flow- AltGr+letter still available for direct accented characters (hold AltGr+a → ä, AltGr+8 → ß)
- Custom
.XComposeoverrides for ẞ and semicolon fallback sequences - Caps Lock → Control via
ctrl:nocaps
- Emacs with custom config (
dot_emacs.d/) emacsclientas default editor (set in.chezmoidata.toml),manopens in Emacs- Neovim config in
dot_config/nvim/(not the default editor) - Emacs config is moving to literate Org:
dot_emacs.d/org/*.org(so fardired.org) are tangled into~/.emacs.d/lisp/init.*.elbyrun_onchange_after_tangle-emacs-config.sh.tmpl; the generated.elfiles are not tracked, the other modules are still plaindot_emacs.d/lisp/init.*.el - Dired alias:
dopens current directory eopens files in Emacs in the terminal,ecin a graphical frame without blocking the shell;ec FILE @2opens FILE in window 2 (modeline number) of the existing graphical frame- File manager: dirvish in Emacs (yazi-style parent, files and preview panes,
SPC o d) and as the sidebar tree (SPC e), set up indot_emacs.d/org/dired.orgto follow the old yazi config
| Task | Purpose |
|---|---|
mise run kernel |
Copy saved config, build kernel, install modules, rebuild initramfs, update limine.conf |
mise run kernel-config-save |
Save /usr/src/linux/.config back to chezmoi (~/.config/kernel/linux.config) |
Kernel upgrade workflow:
eselect kernel set <new>
mise run kernel # applies saved config, builds
# if config needs updating for new kernel:
sudo make -C /usr/src/linux olddefconfig
mise run kernel-config-save # save updated config
git -C ~/.local/share/chezmoi add dot_config/kernel/linux.config && git commit
mise run kernel# Re-run all setup scripts
chezmoi state delete-bucket --bucket=scriptState
chezmoi apply
# Re-run a specific script manually
chezmoi execute-template < run_onchange_install-packages.sh.tmpl | bash
chezmoi execute-template < run_onchange_sync-useflags.sh.tmpl | bash
chezmoi execute-template < run_onchange_after_tangle-emacs-config.sh.tmpl | bash # after editing an Emacs org file- Gentoo Linux with
~amd64in ACCEPT_KEYWORDS - Overlays: guru, another-brave-overlay (testing repo, has brave-origin), pentoo (auto-configured)
GPLv3