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!
These instructions are for setting up new Mac devices. If, instead, you want to get started building your own dotfiles, you can find instructions below.
If you're migrating from an existing Mac, you should first make sure to backup all of your existing data. Go through the checklist below to make sure you didn't forget anything before you migrate.
- 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 backup config settings from apps? For example, look at all the dotfiles and directories in $HOME to see what things you might want to backup and restor. (We used to be able to use Mackup for this, but it no longer works. Maybe search for a replacement!)
After backing up your old Mac you may now follow these install instructions to setup a new one.
-
Update macOS to the latest version through system preferences
-
Generate a new public and private SSH key by running:
curl https://raw.githubusercontent.com/sshead/dotfiles/HEAD/ssh.sh | sh -s "<your-email-address>"
-
Clone this repo to
~/.dotfileswith:git clone --recursive [email protected]:sshead/dotfiles.git ~/.dotfiles
-
Run the installation with:
~/.dotfiles/fresh.sh -
Restore your backed up config values, for example, backed up dotfiles in $HOME.
-
Restart your computer to finalize the process
Your Mac is now ready to use!
💡 You can use a different location than
~/.dotfilesif you want. Make sure you also update the reference in the.zshrcfile.
After you've set up your new Mac you may want to wipe and clean install your old Mac. Follow this article to do that. Remember to backup your data first!
Please note that the instructions below assume you already have set up Oh My Zsh so make sure to first install Oh My Zsh before you continue.
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.
Check out the aliases.zsh file and add your own aliases. If you need to tweak your $PATH check out the path.zsh file. These files get loaded in because the $ZSH_CUSTOM setting points to the .dotfiles directory. You can adjust the .zshrc file to your liking to tweak your Oh My Zsh setup. More info about how to customize Oh My Zsh can be found here.
You can tweak the shell theme, the Oh My Zsh settings and much more. Go through the files in this repo and tweak everything to your liking.
Enjoy your own Dotfiles!
Based on the excellent repo and blog post of Dries Vints:
🔗 Go to the original: https://github.com/driesvints/dotfiles 📖 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