Getting started - macOS (Advanced)

Return to the standard guide

To install Wonderful on your computer, you will need:

• an Apple Silicon (M1 or above)-powered Mac device,
• the most recent version of macOS,
• the following command-line tools provided by your distribution: bash, git, make.
  • Some scripts may expect the version of bash provided by Homebrew.

• Bootstrap (ARM64)

1. Create the /opt/wonderful directory: sudo mkdir /opt/wonderful.
2. Give permissions to /opt/wonderful to your current user: sudo chown -R "$USER" /opt/wonderful.
   1. This allows all subsequent commands, including wf-pacman updates, to be executed without elevated permissions.
3. Extract the bootstrap to /opt/wonderful: cd /opt/wonderful/ && tar xzvf [path_to_bootstrap_tar_gz].
4. Self-sign wf-pacman: codesign --remove-signature /opt/wonderful/bin/wf-pacman && codesign -s - /opt/wonderful/bin/wf-pacman
5. Run /opt/wonderful/bin/wf-pacman -Syu wf-tools (no sudo - you don’t need root!) to synchronize and update the toolchain’s package manager.
6. Run source /opt/wonderful/bin/wf-env to configure the toolchain's environment variables.
   1. See Configuration → Environment variables for more information.
7. Once complete, follow to the post-installation guide.