0xdevalias
commented
1 year ago Setup steps - MacBook Pro 16" (2023) M2 Max (April 2023)
macOS Ventura 13.2.1
Pre-Bootstrap
macOS Installer
Go through the macOS installer, configure any settings as desired:
- Language: English (Australia)
- Country or Region: Australia
- Accessibility
- Vision
- VoiceOver: No
- Zoom: No
- Hover Text: No
- Speak Selection: No
- Pointer Size: Standard
- Reduce Transparency: Standard
- Increase Contrast: Standard
- Appearance: Dark
- Reduce Motion: Standard
- Motor
- Accessibility Keyboard: No
- Hearing
- Closed Captions: No
- Flash for alerts: No
- Cognitive
- Appearance: Dark
- Speak Selection: No
- Typing Feedback: No
- Hover Text: No
- Select Your Wi-Fi Network
- Data & Privacy
- Migration Assistant
- Not Now
- Sign in with Your Apple ID
- Create a Computer Account
- Make This Your New Mac
- Location Services
- Device Analytics
- App Analytivs
- Siri
- Screen Time
- Appearance
- FileVault Disk Encryption
- Touch ID
- Apple Pay
Install System / OS Updates
Once you've booted into macOS for the first time, it probably makes sense to check for any system updates (particularly major OS updates) and install those before continuing.
- Open System Preferences, click Software Update, check for/install any updates
(Optional) Save snapshot of macOS default config
At this stage, it may also be useful to get a snapshot of the default configurations on a freshly installed version of macOS. This can be useful for updating the scripts that configure macOS defaults (see 'dotfiles' section below)
Open Terminal and run the following:
mkdir ~/Desktop/macOS-defaults/
mkdir ~/Desktop/macOS-defaults/domains
defaults read > ~/Desktop/macOS-defaults/defaults-read.txt
defaults domains > ~/Desktop/macOS-defaults/defaults-domains.txt
defaults export -globalDomain - > ~/Desktop/macOS-defaults/defaults-export-globalDomain.xmlThen to export each individual domain's settings as .xml files, we can use the following script:
#!/bin/bash
# ChatGPT Ref: https://chat.openai.com/chat/c03c1acf-5ba2-46a1-878e-020bb4715df6
# Define the output directory
output_dir="$HOME/Desktop/macOS-defaults/domains"
# Get a list of all domains
domains=$(defaults domains)
echo "Exporting domains..."
# Loop through each domain
IFS=", "
for domain in $domains; do
# Export the domain to an XML file
echo " $domain"
defaults export "$domain" - > "${output_dir}/${domain}.xml"
doneBootstrap
(Optional) Install command line development tools.
This will generally be performed as part of the Homebrew install script (see below), but if you want to do it manually, you can do this now (it's required for the default system installations of tools such as git, etc)
- Open Terminal and then run
xcode-select --install
If you try to run a command line tool such as git before installing this, you will see a message similar to the following:
xcode-select: note: no developer tools were found at '/Applications/Xcode.app', requesting install. Choose an option in the dialog to download the command line developer tools.
Install Homebrew
Homebrew is a package manager that makes it easy to install all of the other applications we want on our machine.
It can be easily installed by opening Terminal and running the following command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"We used to have to manually set up the homebrew/cask tap separately, but this is automatically included and enabled by default these days.
(Optional) Universal Control
If you're setting up your new system while you still have your old one running, you can make use of macOS' Universal Control feature to share the same mouse/keyboard between both devices:
- Universal Control: Use a single keyboard and mouse between your Mac and iPad
-
Use the keyboard, mouse or trackpad of your Mac to control up to two other nearby Mac or iPad devices and work seamlessly between them.
-
You can enable this by:
- Open System Settings -> Displays -> Advanced
- Enable Allow your pointer and keyboard to move between any nearby Mac or iPad
To make things easier, you probably also want to arrange your devices similar to how they are actually positioned in real life:
- Open System Settings -> Displays -> Arrange
- Position your screens/devices in a way that mirrors their physical layout
Once this is configured (potentially on both devices), you should be able to 'push' your pointer 'through' the edge of the screen from one device to the other.
Dotfiles, defaults, and core applications
Clone 0xdevalias/dotfiles
Once I have my basic bootstrap tools installed, I can clone my dotfiles repo, and run some more automated setup scripts to get my environment exactly how I like it.
Open Terminal and clone my dotfiles repo. Note that we use https (rather than ssh) to clone for now, as we don't have ssh keys setup on our new machine yet:
git clone https://github.com/0xdevalias/dotfiles.git ~/.dotfilesBootstrap dotfiles (~/.dotfiles/scripts/bootstrap)
Within Terminal, run the dotfiles bootstrap script to configure git and symlink all of the dotfiles configuration into place:
~/.dotfiles/script/bootstrapExample output
```shell % ~/.dotfiles/script/bootstrap [ .. ] setup gitconfig.local [ ?? ] - What is your github author name? Glenn 'devalias' Grant [ ?? ] - What is your github author email? REDACTED@REDACTED.REDACTED TODO: Setup commit signing automagically https://github.com/pstadler/keybase-gpg-github TODO: Setup commit signing https://github.com/pstadler/keybase-gpg-github [ OK ] gitconfig [ .. ] installing dotfiles [ OK ] linked /Users/devalias/.dotfiles/vim/vimrc.symlink to /Users/devalias/.vimrc [ OK ] linked /Users/devalias/.dotfiles/asdf/asdfrc.symlink to /Users/devalias/.asdfrc [ OK ] linked /Users/devalias/.dotfiles/asdf/tool-versions.symlink to /Users/devalias/.tool-versions [ OK ] linked /Users/devalias/.dotfiles/go/cobra.yaml.symlink to /Users/devalias/.cobra.yaml [ OK ] linked /Users/devalias/.dotfiles/gpg/gnupg.symlink to /Users/devalias/.gnupg [ OK ] linked /Users/devalias/.dotfiles/config.symlink to /Users/devalias/.config [ OK ] linked /Users/devalias/.dotfiles/ssh/ssh.symlink to /Users/devalias/.ssh [ OK ] linked /Users/devalias/.dotfiles/iterm2/iterm2.symlink to /Users/devalias/.iterm2 [ OK ] linked /Users/devalias/.dotfiles/iterm2/iterm2_shell_integration.zsh.symlink to /Users/devalias/.iterm2_shell_integration.zsh [ OK ] linked /Users/devalias/.dotfiles/localrc.example.symlink to /Users/devalias/.localrc.example [ OK ] linked /Users/devalias/.dotfiles/zsh/zshrc.symlink to /Users/devalias/.zshrc [ OK ] linked /Users/devalias/.dotfiles/atom.symlink to /Users/devalias/.atom [ OK ] linked /Users/devalias/.dotfiles/ruby/gemrc.symlink to /Users/devalias/.gemrc [ OK ] linked /Users/devalias/.dotfiles/ruby/pryrc.symlink to /Users/devalias/.pryrc [ OK ] linked /Users/devalias/.dotfiles/ruby/irbrc.symlink to /Users/devalias/.irbrc [ OK ] linked /Users/devalias/.dotfiles/git/gitconfig.symlink to /Users/devalias/.gitconfig [ OK ] linked /Users/devalias/.dotfiles/git/gitconfig.local.symlink to /Users/devalias/.gitconfig.local [ OK ] linked /Users/devalias/.dotfiles/git/gitignore_global.symlink to /Users/devalias/.gitignore_global [ OK ] linked /Users/devalias/.dotfiles/starship.symlink to /Users/devalias/.starship All installed! ```TODO: Computer Name
TODO: This should probably get moved into the bootstrap script so it happens automagically
- Choose a name for this computer, configure it
- System Preferences -> Sharing -> Computer Name
- TODO: can we set this from command line as well?
- https://apple.stackexchange.com/questions/66611/how-to-change-computer-name-so-terminal-displays-it-in-mac-os-x-mountain-lion
sudo scutil --set ComputerName "newname"(required)sudo scutil --set LocalHostName "newname"(required)sudo scutil --set HostName "newname"(probably not needed)- Flush the DNS cache:
dscacheutil -flushcache(required?) - Restart computer (required?)
- Can also check current settings with
scutil --get ComputerName(was updated when I change computer name in system preferences)scutil --get LocalHostName(was updated when I change computer name in system preferences)scutil --get HostName("HostName: not set", even after configuring computer name in system preferences (but haven't restarted yet))
- https://knowledge.autodesk.com/search-result/caas/sfdcarticles/sfdcarticles/Setting-the-Mac-hostname-or-computer-name-from-the-terminal.html
TODO: Generate SSH key for GitHub, GitLab, Bitbucket, etc
TODO: This should probably get moved into the bootstrap script so it happens automagically
TODO: We should leverage the GitHub CLI (gh) tool as much as possible here
- Generate SSH key for GitHub, GitLab, Bitbucket, etc:
- TODO: automate this as part of
script/bootstrap - https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent
ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/github_YOURUSERNAME_ed25519- Set a password on this key for extra security
- Once you've created it, you need to add the public key to your GitHub account
cat ~/.ssh/github_devalias_ed25519.pub | pbcopy(this will copy it to the clipboard)- https://github.com/settings/keys
- Click "New SSH Key"
- Title:
YOURUSERNAME@YOURCOMPUTERNAME.local - Key: paste the key you copied above
- Click "Add SSH Key"
- TODO: add ssh config entry for GitHub
- Now we want to add the key to
~/.dotfiles/ssh/keys.initso thatssh-keyinitworks correctly - This file is just a list of the keys to be loaded with
ssh-add - eg.
github_USERNAME_ed25519 bitbucket_USERNAME_rsa gitlab_USERNAME_rsa - Once this is done, we can run
ssh-keyinitonce after restarting our machine, and it will load the specified keys for us - Once you have this SSH key setup, we can change our cloned dotfiles git repo to use SSH instead of HTTPS for it's remote
cd ~/.dotfilesgit remote set-url origin git@github.com:0xdevalias/dotfiles.git
- TODO: automate this as part of
TODO: GPG (git commit signing, etc)
TODO: This should probably get moved into the bootstrap script so it happens automagically, since it's sort of a requirement for fully configuring git + commit signing properly
- GPG (
gpg,pinentry-mac):~/.dotfiles/gpg/install.sh- TODO: move this into the above 'core' list of things?
TODO: Keybase
TODO: This should probably get moved into the bootstrap script so it happens automagically, since it's sort of a semi-requirement for fully configuring git + commit signing properly I think
- Keybase:
brew cask install keybase- Login to Keybase and verify it with one of your previously linked devices
- TODO: anything needed to setup CLI tools, file system, gpg keys, etc?
keybase pgp listkeybase pgp pull-private THEGPGKEYID(repeat for other keys as required)- Once this is done, you may want to update your
signingkeyin~/.dotfiles/git/gitconfig.local.symlink gpg --list-secret-keys --keyid-format LONGgit config --file ~/.gitconfig.local --set user.signingkey THE16CHARKEYID- TODO: this should be automated as part of git config setup in
script/bootstrapor similar
- Once this is done, you may want to update your
- Note: Some of this is closely related to/relies on GPG being setup first
At this point it's worth closing and re-opening Terminal so that the configuration from the dotfiles can take effect.
TODO: Can we reload the shell automagically so we don't have to do it manually here..?
When the Terminal restarts, you might see some errors like the following, these are ok to ignore for now:
Loading antigen..
Error: No such keg: /opt/homebrew/Cellar/antigen
ERROR: Antigen not found. Was it installed with homebrew? Skipping. (/opt/homebrew/share/antigen/antigen.zsh, )Shell prompt customisations (~/.dotfiles/starship.symlink/install.sh)
Our terminal isn't quite looking right yet as we're missing Starship, which manages our shell prompt customisations. We can install that now as follows:
~/.dotfiles/starship.symlink/install.sh Example output
```shell › ~/.dotfiles/starship.symlink/install.sh [starship::install] [require_installed_brew::starship] Required command 'starship' missing. Installing.. ==> Fetching starship ==> Downloading https://ghcr.io/v2/homebrew/core/starship/manifests/1.13.1 ==> Downloading https://ghcr.io/v2/homebrew/core/starship/blobs/sha256:9d12ac9dcb05ca2ea86b943be41eaa32c2850ae429b6fc576c280f1e78514613 ==> Downloading from https://pkg-containers.githubusercontent.com/ghcr1/blobs/sha256:9d12ac9dcb05ca2ea86b943be41eaa32c2850ae429b6fc576c280f1e78514613?se=2023-04-11T07%3A45%3A00Z&sig=Zek7y3tfm5IZ9G0Aqdq6mJVCKzfkpJk2JeZ0ha43Geg%3D&sp=r&spr=https&sr=b&sv=2019-12-12 ==> Pouring starship--1.13.1.arm64_ventura.bottle.tar.gz ==> Caveats zsh completions have been installed to: /opt/homebrew/share/zsh/site-functions ==> Summary 🍺 /opt/homebrew/Cellar/starship/1.13.1: 11 files, 5.7MB ==> Running `brew cleanup starship`... Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP. Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`). Install log: /tmp/brew-install-starship.log ```Once Starship is installed, close and re-open Terminal again, and now things should look more normal:
Basic text/code editor (~/.dotfiles/sublimetext/install.sh)
Some of the next steps will be easier with a basic code/text editor installed, so we'll install Sublime Text next:
~/.dotfiles/sublimetext/install.shExample output
```shell ⇒ ~/.dotfiles/sublimetext/install.sh [sublimetext::install] [require_installed_brew_cask::sublime-text] Required cask 'sublime-text' missing. Installing.. ==> Downloading https://download.sublimetext.com/sublime_text_build_4143_mac.zip ==> Installing Cask sublime-text ==> Moving App 'Sublime Text.app' to '/Applications/Sublime Text.app' ==> Linking Binary 'subl' to '/opt/homebrew/bin/subl' 🍺 sublime-text was successfully installed! Install log: /tmp/brew-cask-install-sublime-text.log [sublimetext] Making settings folder.. (/Users/devalias/Library/Application Support/Sublime Text/Packages/User) [sublimetext] User settings found, moving into dotfiles.. (/Users/devalias/.dotfiles/sublimetext/SublimeSettings) [sublimetext] Symlinking settings path to dotfiles.. (/Users/devalias/Library/Application Support/Sublime Text/Packages/User) ```TODO: Install Node, Python, Ruby, etc
Make any customisations you may need before running. At a minimum, I would suggest checking that the latest versions are setup in:
- TODO: ruby, python, node, etc?
TODO: continue things here
Misc
- Configure macOS sidebar widgets
TODO
Continue setting up new laptop as per the main config steps detailed above
It would be cool to write about how I set up a new laptop, encoding some of my currently more manual processes, and the order that makes most sense in doing so.
Setting up a new laptop
Pre-Bootstrap
Go through the macOS installer, configure any settings as desired.
Once you've booted into macOS for the first time, it probably makes sense to check for any system updates (particularly major OS updates) and install those before continuing.
(Optional) At this stage, it may also be useful to get a snapshot of the default configurations on a freshly installed version of macOS. This can be useful for updating the scripts that configure macOS
defaults(see 'dotfiles' section below)defaults read > ~/Desktop/macOS-defaults.txtBootstrap
(Optional) Install command line development tools.
This will generally be performed as part of the Homebrew install script (see below), but if you want to do it manually, you can do this now (it's required for the default system installations of tools such as
git, etc)xcode-select --installIf you try to run a command line tool such as
gitbefore installing this, you will see a message similar to the following:Install Homebrew
Homebrew is a package manager that makes it easy to install all of the other applications we want on our machine.
It can be easily installed by opening Terminal and running the following command:
Once this is done, you probably also want enable the homebrew 'cask' 'tap', to be able to instal non CLI applications as well:
Dotfiles, defaults and core applications
Once I have my basic bootstrap tools installed, I can clone my dotfiles repo, and run some more automated setup scripts to get my environment exactly how I like it.
Open Terminal and clone my dotfiles repo. Note that we use
https(rather thanssh) to clone for now, as we don't have ssh keys setup on our new machine yet:Make any customisations you may need before running. At a minimum, I would suggest checking that the latest versions are setup in:
Note: I hit a number of issues when running this that we should figure how to fix:
After running the bootstrap, and restarting my terminal, it also seems as though it won't run all of the 'init scripts' correctly, due to missing programs, etc; which eventually cause the shell to exit with an error. These should either be included as part of a 'core required tools' step, or be smart enough to exit cleanly without running if those tools aren't already present:
If you see this, you can say
nfor the time being, then once your shell starts, run the following command to ensure the directories aren't world writeable:compaudit | xargs chmod g-wOnce everything is updated as desired, run
script/bootstrapto install things:At time of writing, this will:
.gitconfig*.symlinkfiles from the dotfiles repo into$HOMEbin/dotwhalebrewand similar package management type things here too?antigenis installedzshis installedNote that the automatic running of installs scripts is a little manual/haphazard at the moment, mostly because I don't necessarily want to automatically install everything on a new machine. I would suggest checking the code to see what will be run, and sanity checking that each is going to do what you want it to. A lot of these scripts end up being run once per new machine, so they can drift/become outdated from my 'ideal setup' over time.
Eventually I would like to clean this up and standardise it a bit more, to be a 'bare minimal' set (eg. core development environments for node, python, ruby, etc. Though I think when that happens, it may make sense to do so as part of adopting a dotfiles management tool (see https://github.com/0xdevalias/dotfiles/issues/8)
For now, refer to the below sections for a more 'manual' list of core installs/setup tasks for a new dev machine. I've roughly attempted to document them in the order I would follow, but this isn't necessarily a hard requirement.
Computer Name
sudo scutil --set ComputerName "newname"(required)sudo scutil --set LocalHostName "newname"(required)sudo scutil --set HostName "newname"(probably not needed)dscacheutil -flushcache(required?)scutil --get ComputerName(was updated when I change computer name in system preferences)scutil --get LocalHostName(was updated when I change computer name in system preferences)scutil --get HostName("HostName: not set", even after configuring computer name in system preferences (but haven't restarted yet))Basic text/code editor
~/.dotfiles/sublimetext/install.shGenerate SSH key for GitHub, GitLab, Bitbucket, etc
script/bootstrapssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/github_YOURUSERNAME_ed25519cat ~/.ssh/github_devalias_ed25519.pub | pbcopy(this will copy it to the clipboard)YOURUSERNAME@YOURCOMPUTERNAME.local~/.dotfiles/ssh/keys.initso thatssh-keyinitworks correctlyssh-addgithub_USERNAME_ed25519 bitbucket_USERNAME_rsa gitlab_USERNAME_rsassh-keyinitonce after restarting our machine, and it will load the specified keys for uscd ~/.dotfilesgit remote set-url origin git@github.com:0xdevalias/dotfiles.gitTerminal/Shell (iTerm2)
~/.dotfiles/iterm2/install.shGPG (git commit signing, etc)
gpg,pinentry-mac):~/.dotfiles/gpg/install.shKeybase
brew cask install keybasekeybase pgp listkeybase pgp pull-private THEGPGKEYID(repeat for other keys as required)signingkeyin~/.dotfiles/git/gitconfig.local.symlinkgpg --list-secret-keys --keyid-format LONGgit config --file ~/.gitconfig.local --set user.signingkey THE16CHARKEYIDscript/bootstrapor similarDevelopment Tools (Java, Node, Python, Ruby, Golang, Swift, Xcode, etc)
jenv, etc):~/.dotfiles/java/install.shnodenv, etc):~/.dotfiles/node/install.shpyenv):~/.dotfiles/python/install.shrbenv):~/.dotfiles/ruby/install.shgoenv)?swiftenv)?brew cask install jetbrains-toolbox~/.dotfiles/xcode/install.sh(TODO: update this?)brew cask install sourcetree(similar togitkrakenbut free)/usr/local/bin/gpgcalledgpg2ln -s /usr/local/bin/gpg /usr/local/bin/gpg2Preferences -> Advanced -> GPG Program/usr/local/bin(it looks for a binary calledgpg2in this folder)Repository -> Repository Settings -> Securitygpg2binary as described abovebrew cask install gitkraken(similar to SourceTree)brew cask install aws-vaultbrew cask install dockerbrew cask install postmanbrew cask install insomnia(optional, similar to postman)Web Browser
brew cask install google-chromebrew cask install chrome-remote-desktop-hostAlfred
brew cask install alfredSettings -> Advanced -> Syncing -> Set preferences folderdefaults read com.runningwithcrayons.Alfreddefaults read com.runningwithcrayons.Alfred-preferencesSettings -> General -> Alfred HotkeySettings -> Features -> Web BookmarksSettings -> Features -> Clipboard HistoryBetterTouchTool
brew cask install bettertouchtoolDropbox -> Backup -> BetterTouchTool)Default (THISCOMPUTER))Settings -> Standard Settings -> Basic -> Launch BetterTouchTool on StartupSettings -> Advanced Settings -> General -> Enable automatic update checkingSettings -> Advanced Settings -> General -> Install Process Priority Helper ToolSettings -> Advanced Settings -> Scripting BTT -> Allow External BetterTouchTool ScriptingSettings -> Advanced Settings -> SyncBartender
brew cask install bartenderHyperdock
brew cask install hyperdockUnsorted
The following don't have any complex setup scripts/environment required, so we can just manually install them with HomeBrew if desired:
brew cask install XXXdisk-inventory-xfluxgemini(duplicate file finder)viscositylastpassdropboxresilio-syncfantasticalPreferences -> AccountsPreferences -> Accounts -> Open maps in -> Google Mapstoggldiscordsignalskypetelegramzoomuslastfm(optional)plexampspotifyvlcblackholenative-accesssoundflowersidequestsony-ps4-remote-playsteambrew install XXX(a small selection, seebrew.*.listfiles for more)aria2awsclicoreutilsdiveexiftoolffmpeggitgnupggogobustergoreleaserhubjqpcreqemuunrarwatchmanUnsorted
script/bootstrapApp Store
We also want to open the App Store, and install any past purchases we want on this machine:
Launchpad
Next we want to organise applications in Launchpad into appropriate folders. While this is controlled by a sqlite database, I'm not currently aware of any tools that allow us to do this automatically, so we'll do it manually for now:
Cleaning up an old laptop before selling/disposing
Unsorted
~/.netrc~/.localrcgpg --gen-revoke KEYIDgpg --import my_revocation.txtgpg --keyserver pgp.mit.edu --send-keys KEYIDkeybase pgp drop KEYBASEKEYIDLegacy