{"id":22808407,"url":"https://github.com/sixarm/sixarm-macos-setup","last_synced_at":"2025-04-22T12:43:09.558Z","repository":{"id":38849023,"uuid":"77801380","full_name":"SixArm/sixarm-macos-setup","owner":"SixArm","description":"SixArm.com » Mac » Setup notes for new Mac computer and macOS","archived":false,"fork":false,"pushed_at":"2025-04-14T08:48:21.000Z","size":155,"stargazers_count":60,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-14T09:46:13.516Z","etag":null,"topics":["iac","mac","macos","script","shell"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SixArm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-01-01T23:32:52.000Z","updated_at":"2025-04-14T08:48:25.000Z","dependencies_parsed_at":"2025-04-14T09:35:28.255Z","dependency_job_id":"06d192d5-4e21-46b7-b254-3e6f3cb0ad5e","html_url":"https://github.com/SixArm/sixarm-macos-setup","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SixArm%2Fsixarm-macos-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SixArm%2Fsixarm-macos-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SixArm%2Fsixarm-macos-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SixArm%2Fsixarm-macos-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SixArm","download_url":"https://codeload.github.com/SixArm/sixarm-macos-setup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250242853,"owners_count":21398210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iac","mac","macos","script","shell"],"created_at":"2024-12-12T11:09:40.858Z","updated_at":"2025-04-22T12:43:09.532Z","avatar_url":"https://github.com/SixArm.png","language":"Shell","readme":"# SixArm macOS Setup\n\nHow to set up a new macOS computer? These notes show how our teams do it.\n\nContents:\n\n* [Introduction](#introduction)\n* [Setup Assistant](#setup-assistant)\n* [Software Update](#software-update)\n* [FileVault](#filevault)\n* [Connect your iPhone, iPad, etc.](#connect-your-iphone-ipad-etc-)\n* [System Preferences and Defaults](#system-preferences-and-defaults)\n* [Applications](#applications)\n* [Defaults](#defaults)\n* [Brew, Cask, MAS](#brew-cask-mas)\n* [Sysadmin notes](#sysadmin-notes)\n* [Developer notes](#developer-notes)\n* [Database notes](#database-notes)\n* [Programming notes](#programming-notes)\n* [JetBrains notes](#jetbrains-notes)\n* [See Also](#see-also)\n\n\n## Introduction\n\nThese notes start with the basics, suitable for typical users.\n\nThese notes continue with more advanced information, suitable for people who are developers and programmers.\n\nWe use Apple macOS current release. We expect most of these notes will work on many versions of macOS.\n\n\n## Setup Assistant\n\nTo setup:\n\n1. Turn on your new computer. This launches the Mac Setup Assistant, which prompts you for your preferred language, time zone, etc.\n\n2. If you already use a different Mac computer, and you want to do a migration of all your files, then you can use the “Migration Assistant”. We prefer to skip this step because we prefer to set up our computer from scratch.\n\n3. Register for a personal Apple Id, if you don't already have one. If you want to use iCloud, do it.\n\n\n## Software Update\n\nTo update your software:\n\n* Choose the Apple menu, then \"Software Update...\".\n\n* This step downloads all the current updates for your system, such as bug fixes, security patches, and feature improvements.\n\n* This step may take a while because macOS updates tend to be large to download. This step may require rebooting.\n\n\n## FileVault\n\nTo use FileVault to encrypt your entire drive:\n\n* Choose the Apple menu, then \"System Preferences....\", then \"FileVault\", then turn on FileVault.\n\n* Write your FileVault password in a secure place; you must have this if you ever want to recover your system.\n\n* This step may take a while, and may require rebooting, because macOS is adding encryption to your entire system.\n\n\n## Connect your iPhone, iPad, etc.\n\nDo you want to sync an iPhone, iPad, or other device? \n\n* If so, connect these now.\n\n* You may want to launch iTunes, because this shows you what is synchronizing.\n\n* If you use iTunes, then you can have iTunes make a backup of your device now.\n\n\n## System Preferences and Defaults\n\nWe set a bunch of system preferences to customize our Desktop, Dock, Keyboard, Sound, and so on.\n\n* Typical users: you can pick and choose from our complete list of \u003ca href=\"notes/system_preferences.md\"\u003eSystem Preferences\u003c/a\u003e\n\n* Advanced users: you can run our script for \u003ca href=\"https://github.com/sixarm/mac-defaults\"\u003emac-defaults\u003c/a\u003e.\n\n\n## Applications\n\nWe add many applications, and we have big lists of our favorites.\n\n* Typical users: you can pick and choose using our list of \u003ca href=\"notes/applications.md\"\u003eapplications\u003c/a\u003e.\n\n* Advanced users: you run our scripts for brew, cask, mas, and so on. See below for these.\n\n\n# For Advanced Users\n\n\n## Defaults\n\nWe set many system preferences and application defaults by using the command `defaults write`.\n\nScript:\n\n  * \u003ca href=\"bin/defaults-write-our-favorites.sh\"\u003edefaults-write-our-favorites.sh\u003c/a\u003e\n\n\n## Brew, Cask, MAS\n\nBrew, Cask, and Mac App Store (MAS), are all very useful for installing apps via the command line. These are the best Mac package managers in our opinion.\n\n* \u003ca href=\"notes/brew.md\"\u003ebrew.md\u003c/a\u003e: Brew package manager\n* \u003ca href=\"notes/mas.md\"\u003emas.md\u003c/a\u003e: Mac App Store (MAS) command line interface\n\n\n## Sysadmin notes\n\n* \u003ca href=\"notes/admin.md\"\u003eadmin.md\u003c/a\u003e: Ensure our user can administer the system\n* \u003ca href=\"notes/environment.md\"\u003eenvironment.md\u003c/a\u003e: Use /etc/environment\n* \u003ca href=\"notes/spotlight.md\"\u003eSpotlight\u003c/a\u003e: skip index on a bunch of folders\n\n\n## Developer notes\n\n* \u003ca href=\"notes/git.md\"\u003egit.md\u003c/a\u003e: Git version control\u003c/a\u003e\n* \u003ca href=\"notes/adium.md\"\u003eadium.md\u003c/a\u003e: Adium instant messenger settings\u003c/a\u003e\n* \u003ca href=\"notes/osx-cpu-temp.md\"\u003eosx-cpu-temp.md\u003c/a\u003e: Command to show the OSX CPU temperature\u003c/a\u003e\n* \u003ca href=\"notes/karabiner.md\"\u003ekarabiner.md\u003c/a\u003e: Karabiner changes the key \"caps lock\" to \"control\" and \"escape\".\n\n\n## Database notes\n\n* \u003ca href=\"notes/mysql.md\"\u003emysql.md\u003c/a\u003e: MySQL database\u003c/a\u003e\n* \u003ca href=\"notes/postgres.md\"\u003epostgres\u003c/a\u003e: Postgres database\u003c/a\u003e\n\n\n## Programming notes\n\n* \u003ca href=\"notes/xcode.md\"\u003excode.md\u003c/a\u003e: Xcode development tools\u003c/a\u003e\n* \u003ca href=\"notes/asdf.md\"\u003egcc.md\u003c/a\u003e: ASDF version manager\u003c/a\u003e\n* \u003ca href=\"notes/gcc.md\"\u003egcc.md\u003c/a\u003e: Gnu Compiler Collection\n* \u003ca href=\"notes/emacs.md\"\u003eemacs.md\u003c/a\u003e: Emacs text editor\u003c/a\u003e\n* \u003ca href=\"notes/iterm2.md\"\u003eiterm2.md\u003c/a\u003e: iTerm2 terminal emulator for Unix shell commands\n* \u003ca href=\"notes/ruby.md\"\u003eruby.md\u003c/a\u003e: Ruby programming\n* \u003ca href=\"notes/java.md\"\u003ejava.md\u003c/a\u003e: Java programming\n* \u003ca href=\"notes/chef.md\"\u003echef.md\u003c/a\u003e: Chef system manager\n* \u003ca href=\"notes/virtualhosts.md\"\u003evirtualhosts.md\u003c/a\u003e: Virtual hosts\n\n\n## JetBrains notes\n\nWe use JetBrains programming software, including Toolbox, DataGrip, WebStorm, etc.\n\nCurrently there is no way to install these using brew, nor the App Store, so we do this:\n\n* Download JetBrains Toolbox, and install it to /Applcations. (Not to a user account location).\n* Set JetBrains Toolbox to install everything to /Applications/JetBrains. (This is so we can more-easily use the software with multiple user accounts on the same machine).\n\n\n## See Also\n\n* [Setting up a Brand New Mac for Development by Tania Rascia](https://www.taniarascia.com/setting-up-a-brand-new-mac-for-development/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixarm%2Fsixarm-macos-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsixarm%2Fsixarm-macos-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsixarm%2Fsixarm-macos-setup/lists"}