Getting Started/Installation

Linux

Requirements

To install Wonderful on your machine, you will need:

  • a Linux distribution released sometime in the last decade (maybe a bit more),
  • a CPU architecture compatible with x86_64 or AArch64.

Installation instructions

  1. Download the Wonderful bootstrap:
  2. Create the /opt/wonderful directory: mkdir /opt/wonderful.
  3. Give permissions to said directory the user who will make use of the toolchain (f.e. chown -R [user] /opt/wonderful)
  4. Extract the bootstrap to /opt/wonderful (f.e. cd /opt/wonderful/ && tar xzvf [path_to_bootstrap_tar_gz]). Other installation locations are not supported.
  5. Add /opt/wonderful/bin to PATH (f.e. export PATH=/opt/wonderful/bin:$PATH).
  6. Export WONDERFUL_TOOLCHAIN to point to /opt/wonderful (f.e. export WONDERFUL_TOOLCHAIN=/opt/wonderful).
  7. Run wf-pacman -Syu (no sudo - you don't need root) to synchronize and update the toolchain's package manager.

For further installation instructions, refer to the specific target(s) you'd like to work with.

Troubleshooting

  • If you run into error setting certificate file: /etc/ssl/certs/ca-certificates.crt while trying to use wf-pacman, you may need to install your distribution's SSL certificates package (f.e. ca-certificates on Debian).

Windows

Native Windows support is currently not available - a third-party solution may come at a later date. For the time being, it is recommended to use a Linux virtual machine or the Windows Subsystem for Linux.

WSL2 troubleshooting

  • 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

macOS

Native macOS support is currently not available.

For the time being, it is recommended to use a Linux virtual machine.