====== Getting started - macOS (Advanced) ======

[[:getting_started|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.

===== Downloads =====

  * [[https://wonderful.asie.pl/bootstrap/wf-bootstrap-darwin-aarch64.tar.gz|Bootstrap (ARM64)]]

===== Installation instructions =====

  - Create the ''/opt/wonderful'' directory: ''%%sudo mkdir /opt/wonderful%%''.
  - Give permissions to ''/opt/wonderful'' to your current user: ''%%sudo chown -R "$USER" /opt/wonderful%%''.
    - This allows all subsequent commands, including ''wf-pacman'' updates, to be executed without elevated permissions. 
  - Extract the bootstrap to ''/opt/wonderful'': ''%%cd /opt/wonderful/ && tar xzvf [path_to_bootstrap_tar_gz]%%''.
  - Self-sign ''wf-pacman'': ''%%codesign --remove-signature /opt/wonderful/bin/wf-pacman && codesign -s - /opt/wonderful/bin/wf-pacman%%''
  - 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.
  - Run ''%%source /opt/wonderful/bin/wf-env%%'' to configure the toolchain's environment variables.
    - See ''Configuration -> Environment variables'' for more information.
  - Once complete, follow to the [[getting_started:finish|post-installation guide]].