getting_started:windows

Getting started - Windows (via MSYS2)

To install Wonderful on your computer, you will need:

Required files:

Install the MSYS2 environment.
Install the Wonderful toolchain from the above installer. (If you’ve installed MSYS2 to a different directory than C:\msys64, adjust it in the Wonderful installer to match.)
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.

This approach is a little experimental, so if it doesn’t work for you, feel free to try the Manual steps below.

Required files:

Install the MSYS2 environment.
From the Start Menu, launch the MSYS UCRT64 shell. This shell is used to interact with the toolchain (make, wf-wswantool, etc).
Install some useful packages: pacman -S base-devel ca-certificates.
Create the /opt/wonderful directory: mkdir /opt/wonderful. Other installation locations are not supported at this time.
Extract the bootstrap to /opt/wonderful (f.e. cd /opt/wonderful/ && tar xzvf [path_to_bootstrap_tar_gz]).
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.
1. See Configuration → Environment variables for more information.
Once complete, follow to the post-installation guide.

These are not recommended and are less tested, but have been used successfully by some users.

Since WSL2 is compatible with Linux, one can follow the Linux installation instructions to get Wonderful running under Windows this way.

If you run into error: could not open file: /etc/mtab: No such file or directory while trying to use wf-pacman, the following command can create the missing file: sudo ln -s /proc/self/mounts /etc/mtab