====== 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.

===== Downloads =====

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

===== Installation instructions =====

  - Create the ''/opt/wonderful'' directory: ''%%sudo mkdir /opt/wonderful%%''. Other installation locations are not supported at this time.
    - On typical Linux installations, ''/opt'' can be only written to by the root user. This is why ''sudo'' is used here to elevate permissions.
  - Give permissions to ''/opt/wonderful'' to your current user: ''%%sudo chown -R "$USER" /opt/wonderful%%''.
    - This allows all subsequent commands, including ''wf-pacman'' updates, to be executed without elevated permissions. 
  - Extract the bootstrap to ''/opt/wonderful'': ''%%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]].

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