Skip to content

macos-maintenance.md

Latest commit

 

History

History
130 lines (112 loc) · 6.13 KB

macos-maintenance.md

File metadata and controls

130 lines (112 loc) · 6.13 KB

macOS Maintenance Notes

Core Maintenance

  • Re-enable softwareupdated and syspolicyd, in case they're disabled.

    sudo launchctl enable system/com.apple.mobile.softwareupdated
sudo launchctl enable system/com.apple.security.syspolicy
sudo launchctl enable system/com.apple.softwareupdated
sudo launchctl load /System/Library/LaunchDaemons/com.apple.mobile.softwareupdated.plist
sudo launchctl load /System/Library/LaunchDaemons/com.apple.security.syspolicy.plist
sudo launchctl load /System/Library/LaunchDaemons/com.apple.softwareupdated.plist
sudo shutdown -r now

  • Update macOS

    • To list available updates: softwareupdate --list.
    • To install an update: softwareupdate --install "<label>".
    • To install an update and restart: sudo softwareupdate --install --restart "<label>".
    • Install the latest version of OpenCore Legacy Patcher, if applicable.
    • Open system applications and make sure they're working as intended.

  • Update dotfiles, hosts and vcpkg

    • cd $DEVELOPER/parteincerta/dotfiles && git pull && ./configure.sh.
    • bash shared/scripts/install-hosts.sh [--force-hostname <host>].
    • bash shared/scripts/install-vcpkg.sh [--tag <tag>].

  • Update MongoDB Shell and Tools

    • Update Shell: bash shared/scripts/install-mongo-utils.sh shell [--version <ver>].
    • Update Tools
      • Update the version number in the script.
      • bash shared/scripts/install-mongo-utils.sh tools [--version <ver>].

  • Update Homebrew applications

    • Quit all apps.
    • Disable app locks: bash shared_macos/scripts/toggle-application-lock.sh --unlock.
    • Update Homebrew itself and the list of formulae: brew update.
    • Upgrade formulae which require specially instructions:
      • brew install --ignore-dependencies gradle jdtls maven zls.
    • Upgrade all installed formulae and casks: brew upgrade --greedy.
    • Configure specific formulae if they got updated:.
      • brew unlink python@3.14 openssl@3.
    • Purge cache: brew cleanup [--dry-run].

  • Update mise plugins and tools

    • Update installed plugins: mise plugins upgrade.
    • Update all outdated tools: mise upgrade.
    • Update a particular tool: mise upgrade <plugin>[@<version>].

  • Update Neovim

    • Update Lazy's plugins: :Lazy sync.
    • Update Mason's registry: :MasonUpdate.
    • Update Mason's LSPs: :Mason -> Press the U key.
    • Update TreeSitter's parsers: TSUpdateSync.

  • Update Python packages

    • List outdated packages: pip3 list --user --outdated.
    • Upgrade specific package pip3 install --user --upgrade <package>.

  • Update Docker plugins and artifacts

    • Check for updated extensions in Docker Desktop.
    • Check for new versions of the Docker images.
    • Run docker compose up for updated images.
    • Run docker image prune --all to remove unused images.
    • Run docker system prune to remove unused artifacts.

  • Other update/maintenance tasks

    • Update Brave's Content Filters lists and clear its cache.
    • Update VSCode plugins.
    • Export updated configurations: bash shared_macos/scripts/export-defaults.sh.
    • Purge caches from CLI tools: purge bash clipboard nvim zsh and purge fish.
    • Install App Store updates.
    • Open all updated applications and make sure they're working as intended.
    • Re-enable app locks: bash shared_macos/scripts/toggle-application-lock.sh.

  • Check if SiP is enabled and disable it if necessary:

  • Re-disable softwareupdated and syspolicyd, in case they were enabled.

    sudo launchctl bootout system/com.apple.mobile.softwareupdated
sudo launchctl bootout system/com.apple.security.syspolicy
sudo launchctl bootout system/com.apple.softwareupdated
sudo launchctl disable system/com.apple.mobile.softwareupdated
sudo launchctl disable system/com.apple.security.syspolicy
sudo launchctl disable system/com.apple.softwareupdated
sudo shutdown -r now

Extra

Homebrew

  • List outdated formulae: brew outdated --greedy.
  • List dependencies of a formula: brew deps --tree <formula>.
  • List (installed) dependent formulae : brew uses --installed <formula>.
  • List installed formulae which are not dependencies of others: brew leaves.
  • List artifacts of a formula: brew ls <formula>.

Mise

  • List installed plugins: mise plugins list.
  • List all available plugins: mise plugins list-all.
  • Install a new plugin: mise plugins install <plugin>.
  • Remove plugin: mise remove <plugin>.
  • List outdated installed tools: mise outdated.
  • Check latest available tool version: mise latest <plugin>[@version].
  • Install latest available tool version: mise install <plugin>[@version].
  • Remove tool version: mise remove <plugin>@<version>.
  • List available versions of a tool tools: mise ls-remote <plugin>.

SSH

  • Generate new keys:
    • RSA: ssh-keygen -t rsa-sha2-512 -b 8192 -C <hostname> -f id_rsa
    • ED25519: ssh-keygen -t ed25519 -C <hostname> -f id_ed25519
  • Set strict permissions for keys and their folder:
    • For the keys: chmod u=r,g=,o= id_*
    • For the folder where they're stored: chmod u=rwx,g=,o= <folder>
  • Check the size of a RSA key: ssh-keygen -l -f id_rsa.pub

Other