===== Getting started - Windows (via MSYS2) =====

To install Wonderful on your computer, you will need:

  * a recent version of Windows - Windows 10 and above are supported,
  * a CPU architecture compatible with x86_64.

===== Installation instructions (Installer) =====

Required files:

  * [[https://wonderful.asie.pl/bootstrap/wf-bootstrap-windows-x86_64.exe|Installer (x86_64)]]

  - Install [[https://www.msys2.org/|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.
  - Once complete, follow to the [[getting_started:finish|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.

===== Installation instructions (Manual) =====

Required files:

  * [[https://wonderful.asie.pl/bootstrap/wf-bootstrap-windows-x86_64.tar.gz|Bootstrap (x86_64, .tar.gz)]]

  - Install [[https://www.msys2.org/|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.
    - See ''Configuration -> Environment variables'' for more information.
  - Once complete, follow to the [[getting_started:finish|post-installation guide]].

===== Alternative options =====

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

==== Windows (via WSL2) ====

Since WSL2 is compatible with Linux, one can follow [[getting_started:linux|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%%''