Skip to main content

Installation

macOS Notes​

You need to have XCode or, at the very minimum, the XCode Command Line Tools, which are available as a much smaller download.

The easiest way to install the XCode Command Line Tools is to open up a terminal, type xcode-select --install and follow the prompts.

Ubuntu / WSL Notes​

You should at least update/upgrade APT with sudo apt-get -qq update && sudo apt-get -qq dist-upgrade first.

Heed this critically important warning before you install​

If you're not me, please do not install dotfiles directly from this repo!

Why? Because I often completely break this repo while updating. Which means that if I do that and you run the dotfiles command, your home directory will burst into flames, and you'll have to go buy a new computer. No, not really, but it will be very messy.

Actual installation​

  1. Read my gently-worded note
  2. Fork this repo
  3. Open a terminal/shell and do this (change andrelin and main as appropriate):

Ubuntu / WSL​

export DOTFILES_GH_USER=andrelin
export DOTFILES_GH_BRANCH=main
bash -c "$(wget -qO- https://raw.github.com/$DOTFILES_GH_USER/dotfiles/$DOTFILES_GH_BRANCH/bin/dotfiles)" && source ~/.zshrc

macOS​

export DOTFILES_GH_USER=andrelin
export DOTFILES_GH_BRANCH=main
bash -c "$(curl -fsSL https://raw.github.com/$DOTFILES_GH_USER/dotfiles/$DOTFILES_GH_BRANCH/bin/dotfiles)" && source ~/.zshrc

Since you'll be using the dotfiles command on subsequent runs, you'll only have to set the DOTFILES_GH_USER variable for the initial install, but if you have a custom branch, you will need to export DOTFILES_GH_BRANCH for subsequent runs.

There's a lot of stuff that requires admin access via sudo, so be warned that you might need to enter your password here or there.

The scripts need bash 5.0 or newer. A fresh Mac only has Apple's bash 3.2, so on the first run dotfiles installs Homebrew and its bash before anything else, then restarts itself under that bash.

Actual installation (for me)​

Ubuntu / WSL​

bash -c "$(wget -qO- https://raw.github.com/andrelin/dotfiles/main/bin/dotfiles)" && source ~/.zshrc

macOS​

bash -c "$(curl -fsSL https://raw.github.com/andrelin/dotfiles/main/bin/dotfiles)" && source ~/.zshrc