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.

1. Install the MSYS2 environment.
2. Download the Installer (x86_64) and run it.
   1. If you've changed the MSYS2 installation directory, make sure to also change it in Wonderful's installer.
3. Run Wonderful Toolchain Shell from the Start Menu.
   1. 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 post-installation guide. Manual installation instructions are available here.

1. Download the Installer script.
2. Run it from your shell: chmod +x wf-installer.sh && ./wf-installer.sh
3. Follow the instructions.

Once complete, follow to the post-installation guide. Manual installation instructions are available here.

1. Download the Installer script.
2. Run it from your shell: chmod +x wf-installer.sh && ./wf-installer.sh
3. Follow the instructions.

Once complete, follow to the post-installation guide. Manual installation instructions are available here.