====== Installation ======

The following platforms are supported as of writing:

  * Windows 10 or above,
  * Linux with a recent kernel version (x86-64 and AArch64 architectures supported),
  * macOS 26 or above (Apple Silicon hardware only).

Other platforms, such as FreeBSD, are not currently supported. On such platforms, you may wish to set up a Linux container or virtual machine.

===== Windows =====

  - Install [[https://www.msys2.org/|the MSYS2 environment]].
  - Download the [[https://wonderful.asie.pl/bootstrap/wf-bootstrap-windows-x86_64.exe|Installer (x86_64)]] and run it.
    - If you've changed the MSYS2 installation directory, make sure to also change it in Wonderful's installer.
  - Run ''Wonderful Toolchain Shell'' from the Start Menu.
    - Remember to use this option to launch the Wonderful shell! Using the default MSYS2 shells will not initialize environment variables correctly, leading to programs and toolchains not working correctly.

Once complete, follow to the [[getting_started:finish|post-installation guide]]. Manual installation instructions are available [[getting_started:windows|here]].

===== Linux =====

  - Download the [[https://wonderful.asie.pl/bootstrap/wf-installer.sh|Installer]] script.
  - Run it from your shell: ''%%chmod +x wf-installer.sh && ./wf-installer.sh%%''
  - Follow the instructions.

Once complete, follow to the [[getting_started:finish|post-installation guide]]. Manual installation instructions are available [[getting_started:linux|here]].

===== macOS =====

  - Download the [[https://wonderful.asie.pl/bootstrap/wf-installer.sh|Installer]] script.
  - Run it from your shell: ''%%chmod +x wf-installer.sh && ./wf-installer.sh%%''
  - Follow the instructions.

Once complete, follow to the [[getting_started:finish|post-installation guide]]. Manual installation instructions are available [[getting_started:macos|here]].