dotfiles

My personal dotfiles

Content

• Automatic zsh setup with oh-my-zsh and various plugins. See setup_zsh.sh and the comments in .zshrc and zsh/plugins.
• Automatic setup and installation of various Homebrew packages. See Brewfile and setup_brew.zsh. Descriptions of the packages and alternative installation methods without Homebrew are provided in packages.md.
• Creation of a new .gitconfig in the user home which includes the settings from this repo's .gitconfig. See setup_gitconfig.sh.
• Backups of my Solaar configuration for MX Keys and MX Anywhere 3.
• Some generic .bash_aliases for when using bash. Install with wget -O $HOME/.bash_aliases https://github.com/ninagrosse/dotfiles/raw/refs/heads/main/.bash_aliases

Prerequisites

To use the setup scripts, zsh and Homebrew need to be installed manually first. See their respective docs for instructions. After installing, setup_zsh.sh should be run first, because setup_brew.zsh requires oh-my-zsh to be installed. If Homebrew isn't used or can't be installed, just skip its installation and setup.

The settings in this repo's .gitconfig use delta as the core.pager, so delta needs to either be installed (it is included in Brewfile) or core.pager needs to be overwritten at the end of $HOME/.gitconfig after creating a new one with setup_gitconfig.sh. Configurations for credentials etc. should be placed in the newly created $HOME/.gitconfig as well, so they don't get committed.

Installation

Clone the repo to $HOME/.dotfiles (the path is important)

git clone [email protected]:ninagrosse/dotfiles.git $HOME/.dotfiles
cd $HOME/.dotfiles

Run the setup scripts individually and reload zsh

./setup_zsh.sh
./setup_brew.zsh
./setup_gitconfig.sh
exec zsh

Or run the all-in-one script

./setup_all.sh
exec zsh

Testing

To test the setup scripts, there is a Dockerfile which is based on the latest Ubuntu. It installs some required tools (vim nano curl git zsh brew tree build-essential) and copies all dotfiles, except the .gitignore'd ones, to /root/.dotfiles.

Build the image with docker build -t <some tag> .

Launch a container with docker container run -it --rm <some tag> bash

Inside the container execute the setup scripts to test.