Dotfiles designed to work out of the box on macOS and debian based systems with bash terminals.

Disclaimer: You are free to do whatever you want with the files and code in this repository. However these dotfiles are tailored to my personal use, and may not work for you. Running the setup script may overwrite existing files/settings on your system. You should not implement a configuration if you do not know what it does. Learn more about dotfiles philosophy on the GitHub does dotfiles community website.

All bash related dotfiles with the exception of .bash_profile and .bashrc live within the .system directory. Any dotfiles put into the .system directory are automatically sourced, this is .bash_profile's only purpose. .bashrc does nothing beside source .bash_profile.

Mac systems now use zsh as the default shell. To use these dotfiles you must be using bash. The default shell is changed with the chsh command.

chsh -s /bin/bash

You will be prompted to enter your password.

If running on a Mac: Install XCode Command Line Tools.

xcode-select --install

If running on an M1 Mac: Install Rosetta 2.

softwareupdate --install-rosetta

Clone the repository to wherever you store projects.

git clone https://github.com/imjackson/dotfiles.git

or

git clone git@github.com:imjackson/dotfiles.git

Run the setup script from within the newly cloned directory.

cd dotfiles
./setup

This creates a symbolic link between the dotfiles directory and your home directory for .bash_profile, .bashrc, .inputrc, .vimrc, .tmux.conf, .gitignore_global, .hushlogin, Brewfile, and the .system directory. To avoid collision, the .gitconfig file is copied into your home directory as opposed to being symlinked.

You can also run the optional brew_setup script if you are on a macos system.

./brew_setup

This script will install Homebrew if it isn't already, then run brew bundle on the Brewfile. This will install a list of useful (and some updated) binaries, as well as a list of applications I use via Homebrew casks.

.system/.exports adds the brew installation locations to the $PATH, ensuring that binaries installed with brew will be used first. There are additional steps to using updated bash, however.

First, bash downloaded with brew must be added to the known shells file: /etc/shells. You can find where brew placed the bash by running which bash. On M1 Mac it is located at: /opt/homebrew/bin/bash.

sudo -s
echo "$(which bash)" >> /etc/shells
exit

Make sure you exit the root session before doing anything else in your terminal!

Use chsh to change the default shell.

chsh -s /opt/homebrew/bin/bash

You will be prompted to enter your password.

The use of symbolic links allows you to edit the dotfiles without working directly within your home folder. After altering a dotfile that lives within .system, ~/.bashrc must be sourced (this can be done with the resource alias) or the terminal must be restarted.

This repository is maintained with the GNU General Public License v3.0.

These dotfiles are heavily inspired by those listed below.

• Mathias Bynens' dotfiles
• webpro's dotfiles
• thoughtbot's dotfiles