macos

Bootstrapping the setup.sh script

1. Sign-in to apple ID
2. Start a download for a system update
3. Install homebrew via brew.sh
4. Temporarily add Homebrew to this shell with eval "$(/opt/homebrew/bin/brew shellenv)"; do not add it to .zshrc, since link.sh will install the dotfiles
5. While that's happening, sign in to github.com.
6. brew install gh
7. gh auth login
8. gh repo clone matthewgrossman/dotfiles
9. cd dotfiles/mac; ./setup.sh

The first program installed should be google-drive, which is a first priority to get access to keepass.

1. Sign into Google Drive
2. Open keepassxc with gdrive://sync/pwdb.kdbx

This script will end up prompting for password a few times (ideally at the beginning), so check on it periodically.

KeePassXC

1. Enable browser integration in Settings > Browser Integration
2. Disable "Lock databases when the session is locked or the lid is closed"
3. Prevent KeePassXC from replacing the database file so KeePassium does not lose its file reference:
   • Go to Settings > General > Basic Settings > File Management
   • Enable "Use alternative saving method" and select "Directly write to database file (dangerous)"
   • Enable "Backup database file before saving"
   • If KeePassium already lost the file reference, open the existing database again from KeePassium's Databases screen
   • See the KeePassium troubleshooting guide for details

SOPS age key

The homelab repository uses SOPS with age to keep secrets encrypted in Git. To edit or decrypt those secrets on a new computer, retrieve the SOPS age private key from the password manager and install it at SOPS's default key location:

mkdir -p ~/.config/sops/age
# use keepassxc to download keys.txt to `~/.config/sops/age/keys.txt`

Never commit or otherwise copy this private key into either repository.

setup.sh should handle lots of default macos settings, but AFAIK these still require manual clicking:

1. Disable cmd-space for spotlight in keyboard settings (and modify alfred to use this instead)
2. Map Caps Lock to Control in System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys
3. Select the denser scaled resolution in System Settings > Displays
4. Set up the display arrangement for the desk in System Settings > Displays > Arrange
5. Turn off auto-brightness in Displays
6. Enable bluetooth in the top bar

Alfred

1. Enter the powerpack info, search gdrive for "alfred"
2. Point the settings at gdrive://sync/alfred.kdbx
3. Change the theme
4. Enable clipboard history

Steermouse

1. Search email for "steermouse" to get the registration info.
2. If you haven't in awhile, export the profile from the old machine into gdrive://sync/
3. Import settings of gdrive://sync/Default.smsetting_app
4. The most recent time I did this, I had issues that simply restarting resolved. I also had to unplug my dock, which was wild.

windows

1. Open Powershell as administrator and run the following:

   winget install -e Git.Git
   cd $HOME
   git clone https://github.com/matthewgrossman/dotfiles
   powershell -ExecutionPolicy Bypass -File .\dotfiles\windows\setup.ps1

There are some apps that can't be installed via that script:

• The NVIDIA app
• AMD Chipset Driver ("Adrenalin")

wsl2 / ubuntu

1. Ensure you have github-allowlisted ssh keys
2. Run the following:

$> git clone git@github.com:matthewgrossman/dotfiles.git
$> cd dotfiles
$> sh link.sh
$> sh windows/setup_wsl.sh