Skip to content

linux.md

Latest commit

 

History

History
131 lines (94 loc) · 3.92 KB

linux.md

File metadata and controls

131 lines (94 loc) · 3.92 KB
Raw

Linux

Linux setup follows the same three-layer model as macOS and Windows:

  • bootstrap: install platform prerequisites, Homebrew for Linux, and chezmoi
  • required state: apply managed dotfiles and required Linuxbrew packages
  • optional setup: install heavier language runtimes, LunarVim, or machine preferences explicitly

The goal is a Mac-like zsh environment on Linux, not a copy of macOS paths. Shared shell files are templated so Linux receives the zsh, Oh My Zsh, Powerlevel10k, tmux, editor, Git, and CLI-tool configuration while macOS-only apps and SDK paths stay on macOS.

Bootstrap

For CentOS-like distributions with dnf, including CentOS Stream, RHEL, Rocky Linux, AlmaLinux, and Fedora-like hosts, run:

/bin/bash ./bootstrap/centos.sh

The dnf bootstrap installs Linuxbrew prerequisites with:

sudo dnf group install 'Development Tools'
sudo dnf install procps-ng curl file

It also ensures git and zsh are present for the dotfiles workflow. After the system prerequisites are present, it installs Homebrew for Linux when missing, installs chezmoi through Homebrew, initializes ~/.local/share/chezmoi, and stops before applying changes.

Review the pending changes before applying them:

eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
chezmoi diff
chezmoi apply
chsh -s "$(command -v zsh)"

After the first chezmoi apply, the managed zsh files add Linuxbrew to shell startup and chezmoi downloads Oh My Zsh, Powerlevel10k, and the configured zsh plugins. Before that, the eval command above makes brew and chezmoi available only in the current shell. The bootstrap deliberately leaves chsh explicit because it changes an account-level setting and can require an interactive password. Start a new login session after it succeeds. If you do not want to change the current shell environment, use the absolute path instead:

/home/linuxbrew/.linuxbrew/bin/chezmoi diff
/home/linuxbrew/.linuxbrew/bin/chezmoi apply

The Ubuntu WSL bootstrap remains separate in bootstrap/wsl.sh because it uses apt-get prerequisites and WSL-specific setup notes.

Required Packages

Required Linux packages live in:

  • packages/Brewfile.required
  • packages/Brewfile.linux.required

During chezmoi apply, the Linux chezmoi onchange script checks that Homebrew is present and runs:

brew bundle --file=packages/Brewfile.required install
brew bundle --file=packages/Brewfile.linux.required install

Use packages/Brewfile.required for CLI tools shared with macOS when the Homebrew formula name is portable. Keep Linux-only formulae in packages/Brewfile.linux.required and macOS-only formulae such as pinentry-mac in the macOS Brewfile.

Optional Toolchains

Optional Linux toolchains live in:

  • packages/Brewfile.toolchains
  • packages/Brewfile.linux.toolchains

Install them explicitly:

chezmoi cd
bash ./scripts/install-linux-toolchains.sh

This script also installs LunarVim with the official Linux/macOS installer, matching the Windows and macOS model where LunarVim setup is explicit rather than part of routine chezmoi apply.

Docker is intentionally not installed through Linuxbrew. On WSL, install Docker Engine through apt and systemd with:

chezmoi cd
bash ./scripts/install-wsl-docker.sh

See wsl.md for the Docker verification steps.

Optional Apps And Fonts

Shared optional Homebrew packages can be installed explicitly:

chezmoi cd
bash ./scripts/install-linux-apps.sh

There is no Linux fonts script yet. Add scripts/install-linux-fonts.sh only when targeting a full Linux desktop where user-font installation can be handled without distro-specific assumptions.

Local Private Config

Keep machine-specific Linux values in local files:

  • ~/.zshrc.local.pre
  • ~/.zshrc.local
  • ~/.zprofile.local
  • ~/.gitconfig.local

These are intentionally unmanaged and can hold proxy, worktree, credential, or host-specific settings.