Skip to content

5. Run first boot

Goal: copy the package to the Mac mini and run first-boot.sh as admin, at the Mac mini's own display and keyboard.

Steps

  1. Turn on the Mac mini and complete Apple's Setup Assistant. Create the admin account. Do not turn on FileVault: it blocks the operator's automatic login. The Apple first-boot dialog guide covers each dialog.
  2. On the Mac mini, open AirDrop in Finder (Shift-Command-R) and set "Allow me to be discovered by" to Everyone.
  3. On the dev Mac, AirDrop the ~/macmini-setup folder to the Mac mini. It arrives in ~/Downloads/macmini-setup.
  4. On the Mac mini, open Terminal and go to the package:

    cd ~/Downloads/macmini-setup
    
  5. Make sure that FileVault is off and the disk is fully decrypted:

    fdesetup status
    

    The output must be FileVault is Off. If FileVault is on, turn it off in System Settings > Privacy & Security > FileVault. Wait until fdesetup status prints FileVault is Off., which can take an hour or more. The script also offers to turn FileVault off, but turning it off before you run the script is the tested path.

  6. Run the script. Do not run it over SSH: it stops unless it runs in a desktop session.

    ./first-boot.sh
    
  7. Press Enter at "This script will configure your Mac Mini server. Continue?".

  8. Enter the admin password when the script asks for it. Later sudo prompts show a label in brackets, such as [SSH setup]. Enter the admin password at each one.
  9. Answer the Touch ID for sudo and Wi-Fi prompts.
  10. If the SSH step asks you to give Terminal Full Disk Access, do these steps:

    1. Drag Terminal from the Finder window into the Full Disk Access list in System Settings.
    2. Close every Terminal window.
    3. Open a new Terminal window and run the script again:

      cd ~/Downloads/macmini-setup && ./first-boot.sh
      
  11. Turn on Screen Sharing when the script opens System Settings. Then sign in to the Apple Account. The script opens a one-time 1Password link to the password.

  12. Wait while the script installs the Command Line Tools, Homebrew and the packages. This part takes the longest.

  13. At the end, a "Server Setup Complete" dialog opens. Click OK. A new Terminal window opens in ~/app-setup. Keep it open. You run app setup in it in tutorial step 6, before any restart.

Warning

Do not use --force on a first run. It skips the password prompt, and the keychain import needs that password.

For the prompts, options and errors in detail, see First boot.

Check

  1. The summary says Setup completed successfully with no errors or warnings!, or it lists only warnings that you understand. Some steps log a problem without adding it to the summary, so also search the full log:

    grep -E '❌|⚠️' ~/.local/state/macmini-setup.log
    

    Read each line that it prints. No output means no module reported a problem. 2. The operator account exists and logs in automatically:

    dscl . -read /Users/operator UserShell
    defaults read /Library/Preferences/com.apple.loginwindow autoLoginUser
    

    The second command prints operator.

  2. The app setup folder exists:

    ls ~/app-setup/run-app-setup.sh ~/app-setup/config/config.conf
    
  3. From the dev Mac, SSH works with your key:

    ssh admin@macmini.local true
    

Next: Run app setup