Differences

This shows you the differences between two versions of the page.

--- getting_started [2025/08/30 15:00] – asie
+++ getting_started [2026/06/13 16:37] (current) – asie
@@ Line 1: / Line 1: @@
 ====== Installation ======
-First, select your preferred platform:
+The following platforms are supported as of writing:
-  * [[getting_started:windows|Windows]]
+  * Windows 10 or above,
-  * [[getting_started:linux|Linux]] (x86_64, AArch64)
+  * Linux with a recent kernel version (x86-64 and AArch64 architectures supported),
+  * macOS 26 or above (Apple Silicon hardware only).
-Other platforms, such as macOS, are not currently supported. On such platforms, you may wish to set up a Linux container or virtual machine.
+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]].