/dotfiles

Public repo for my personal dotfiles

Primary LanguageShellMIT LicenseMIT

Originally by Dries Vints, make sure to check out his repo as it contains more configuration options

Jan's Dotfiles

This repository serves as my way to help me setup and maintain my Mac. It takes the effort out of installing everything manually. Everything needed to install my preferred setup of macOS is detailed in this readme. Feel free to explore, learn and copy parts for your own dotfiles. Enjoy! 😄

📖 Read the blog post: https://driesvints.com/blog/getting-started-with-dotfiles
📹 Watch the screencast on Laracasts: https://laracasts.com/series/guest-spotlight/episodes/1

A Fresh macOS Setup

These instructions are for when you've already set up your dotfiles. If you want to get started with your own dotfiles you can find instructions below.

Before you re-install

First, go through the checklist below to make sure you didn't forget anything before you wipe your hard drive.

  • Did you commit and push any changes/branches to your git repositories?
  • Did you remember to save all important documents from non-iCloud directories?
  • Did you save all of your work from apps which aren't synced through iCloud?
  • Did you remember to export important data from your local database?
  • Did you update mackup to the latest version and ran mackup backup?

Installing macOS cleanly

After going to our checklist above and making sure you backed everything up, we're going to cleanly install macOS with the latest release. Follow this article to cleanly install the latest macOS version.

Setting up your Mac

If you did all of the above you may now follow these install instructions to setup a new Mac.

  1. Update macOS to the latest version through system preferences

  2. Generate a new public and private SSH key by running:

    curl https://raw.githubusercontent.com/driesvints/dotfiles/HEAD/ssh.sh | sh -s "<your-email-address>"
  3. Clone this repo to ~/.dotfiles with:

    git clone --recursive git@github.com:Echelpoel/dotfiles.git ~/.dotfiles
  4. Run the installation with:

    ~/.dotfiles/install.sh
  5. After mackup is synced with your cloud storage, restore preferences by running mackup restore

  6. Restart your computer to finalize the process

Your Mac is now ready to use!

Your Own Dotfiles

If you want to start with your own dotfiles from this setup, it's pretty easy to do so. First of all you'll need to fork this repo. After that you can tweak it the way you want.

Go through the .macos file and adjust the settings to your liking. You can find much more settings at the original script by Mathias Bynens and Kevin Suttle's macOS Defaults project.

Check out the Brewfile file and adjust the apps you want to install for your machine. Use their search page to check if the app you want to install is available.

When installing these dotfiles for the first time you'll need to backup all of your settings with Mackup. Install Mackup and backup your settings with the commands below. Your settings will be synced to iCloud so you can use them to sync between computers and reinstall them when reinstalling your Mac. If you want to save your settings to a different directory or different storage than iCloud, checkout the documentation.

brew install mackup
mackup backup