Dotfiles

Personal dotfiles for macOS and Debian 12 (WSL2) development environments.

Features

• Shell: zsh with oh-my-zsh and plugins (autosuggestions, docker)
• Editor: NeoVim with vim-plug and CoC LSP
• Terminal Multiplexer: tmux with TPM
• Version Managers: RVM (Ruby), rustup (Rust)
• Languages: Ruby (via RVM), Rust (via rustup), Python 3
• JavaScript Runtime: Bun
• Development Tools: Git, Ansible, various CLI utilities (bat, jq, shellcheck, etc.)

Supported Platforms

• macOS (tested on Monterey, Ventura, Sonoma)
  • Apple Silicon: packages via Homebrew
  • Intel: packages via MacPorts, since Homebrew no longer supports Intel Macs
• Debian 12 (WSL2 and native)

Quick Start

macOS Installation

# Clone the repository
mkdir -p ~/Projects
cd ~/Projects
git clone https://github.com/gruz0/dotfiles.git
cd dotfiles

# Run installation
./install-macos.sh

The script will:

• Install Command Line Tools (if needed)
• Install/update Homebrew (Apple Silicon) or MacPorts (Intel)
• Install all CLI packages
• Install GUI applications (Apple Silicon only; on Intel it prints a list to download manually)
• Set up oh-my-zsh, RVM, Rust, Bun, NeoVim, and tmux
• Apply macOS system settings
• Symlink configuration files

Debian 12 (WSL2) Installation

# Clone the repository
mkdir -p ~/Projects
cd ~/Projects
git clone https://github.com/gruz0/dotfiles.git
cd dotfiles

# Run installation
./install-debian12.sh

The script will:

• Update apt repositories
• Install all CLI development tools via apt
• Install Ansible (via Ubuntu PPA)
• Set up oh-my-zsh, RVM, Rust, Bun, NeoVim, and tmux
• Configure SSH settings (optional)
• Symlink configuration files

What Gets Installed

macOS

CLI Tools (via Homebrew or MacPorts)

Languages:

• Go, Node.js, Python, Deno

Version Control:

• Git, Subversion

Editors & Tools:

• NeoVim, tmux, zsh

Development:

• cmake, automake, pkg-config, shellcheck, hadolint

Utilities:

• bat, jq, tree, wget, curl

GUI Applications (via Homebrew Casks, Apple Silicon only)

Browsers:

• Chrome, Brave

Development:

• Docker, iTerm2, DBeaver

Productivity:

• 1Password, Telegram, Zoom

Utilities:

• The Unarchiver, Fira Code font

System Settings

• Faster key repeat, no press-and-hold
• Dock on left, auto-hide enabled
• Show hidden files in Finder
• List view as default in Finder
• Time Machine exclusions for Downloads, Music, Movies, Pictures, and development directories

Debian 12 (WSL2)

Packages (via apt)

Build Tools:

• build-essential, pkg-config

Languages:

• Python 3, python3-pip

Version Control:

• Git

Editors & Tools:

• NeoVim (installed from GitHub release), tmux, zsh

Development:

• shellcheck

Utilities:

• bat, curl, gnupg, jq, ripgrep, time, tree, unzip, wget

System Libraries:

• coreutils, zlib1g

Special Installations

Via Ubuntu PPA:

• Ansible (installed via Ubuntu PPA for Debian 12 compatibility)

Note: GUI applications are not installed on Debian as it's designed for headless/WSL2 environments.

Shared Installations (Both Platforms)

• oh-my-zsh with custom gruz0 theme and plugins
• RVM (Ruby Version Manager)
• rustup (Rust toolchain manager, installs the stable toolchain)
• Bun (JavaScript runtime and package manager)
• vim-plug and NeoVim plugins
• TPM (tmux plugin manager)

Both rustup and Bun are installed from their official install scripts into ~/.cargo and ~/.bun. The upstream installers append PATH lines to shell rc files; that is suppressed (--no-modify-path for rustup, a hidden $SHELL for Bun) because assets/.zshrc and assets/.bash_profile already set up both.

On Debian, do not install rustc/cargo from apt: rustup's ~/.cargo/bin shadows /usr/bin, so you end up with two toolchains and a stale one in the way.

Platform-Specific Installations

macOS:

• Python packages: neovim, ansible-vault (via pip)

Debian:

• Ansible (installed via Ubuntu PPA - see lib/install-ansible.sh)

Configuration Files

All configuration files are symlinked from the assets/ directory:

• .zshrc - zsh configuration with aliases and environment variables
• .tmux.conf - tmux configuration with custom key bindings
• .config/nvim/init.vim - NeoVim configuration
• .config/nvim/coc-settings.json - CoC LSP settings
• .gitconfig - Git configuration
• .claude/settings.json - Claude Code settings (model, theme, plugins, status line)
• .claude/statusline-command.sh - Claude Code status line script
• .ssh/ - SSH configuration and keys
• .editorconfig - Editor indentation rules
• And more...

Customization

Adding Packages

macOS:

• Edit packages/macos-brew.txt for CLI tools (Apple Silicon)
• Edit packages/macos-ports.txt for CLI tools (Intel). MacPorts names can differ from Homebrew's, search at https://ports.macports.org
• Edit packages/macos-casks.txt for GUI applications

Debian:

• Edit packages/debian-apt.txt

Then re-run the installation script.

Adding Configuration Files

1. Add your config file to the assets/ directory
2. Add the relative path to config/symlinks.txt
3. Re-run the deployment: ./lib/deploy-configs.sh

Modifying Installation

All installation logic is in modular scripts under lib/:

• lib/install-homebrew.sh - Homebrew, CLI packages and GUI apps (Apple Silicon)
• lib/install-macports.sh - MacPorts and CLI packages (Intel)
• lib/install-zsh.sh - zsh and oh-my-zsh setup
• lib/install-ruby.sh - RVM and Ruby
• lib/install-rust.sh - Rust toolchain via rustup
• lib/install-bun.sh - Bun runtime and zsh completions
• lib/install-neovim.sh - NeoVim and plugins
• lib/install-tmux.sh - tmux and TPM
• lib/install-python-tools.sh - Python packages (neovim, ansible-vault)
• lib/install-ansible.sh - Ansible via Ubuntu PPA (Debian only)
• lib/deploy-configs.sh - Symlink configurations

Testing

Test the installation scripts without running them:

# Test macOS scripts
./tests/test-macos.sh

# Test Debian scripts
./tests/test-debian12.sh

These tests verify that all required files exist and scripts have valid syntax.

Troubleshooting

macOS: Command Line Tools Not Found

If you see errors about missing compilers:

xcode-select --install

zsh: command not found after installation

Restart your terminal or run:

exec zsh

NeoVim plugins not loading

Run the plugin install manually:

nvim +PlugInstall +qall

Permission denied for SSH keys

Fix SSH permissions:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_*
chmod 644 ~/.ssh/*.pub
chmod 600 ~/.ssh/config

Homebrew or MacPorts not found (macOS)

.zshrc adds both to PATH when they are installed. In another shell, run:

eval "$(/opt/homebrew/bin/brew shellenv)"           # Apple Silicon (Homebrew)
export PATH="/opt/local/bin:/opt/local/sbin:$PATH"  # Intel (MacPorts)

Architecture

This repository uses a modular bash script architecture:

dotfiles/
├── install-macos.sh        # macOS entry point
├── install-debian12.sh     # Debian entry point
├── lib/                    # Shared installation scripts
├── packages/               # Package lists by OS
├── config/                 # Installation configuration
└── assets/                 # Dotfiles to symlink

Each component is designed to be:

• Idempotent: Safe to run multiple times
• Modular: Independent scripts for each tool
• Cross-platform: Shared code works on both macOS and Debian
• Verbose: Clear logging with color-coded output

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch
3. Test your changes on both macOS and Debian if possible
4. Submit a pull request

License

MIT

Author

Created and maintained by gruz0