Getting started - Linux

To install Wonderful on your computer, 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,
• the following command-line tools provided by your distribution: bash, git, make.

• Bootstrap (x86_64)
• Bootstrap (AArch64)

1. Create the /opt/wonderful directory: sudo mkdir /opt/wonderful. Other installation locations are not supported at this time.
   1. On typical Linux installations, /opt can be only written to by the root user. This is why sudo is used here to elevate permissions.
2. Give permissions to /opt/wonderful to your current user: sudo chown -R "$USER" /opt/wonderful.
   1. This allows all subsequent commands, including wf-pacman updates, to be executed without elevated permissions.
3. Extract the bootstrap to /opt/wonderful: cd /opt/wonderful/ && tar xzvf [path_to_bootstrap_tar_gz].
4. 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.
5. Run source /opt/wonderful/bin/wf-env to configure the toolchain's environment variables.
   1. See Configuration → Environment variables for more information.
6. Once complete, follow to the post-installation guide.

• 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).