diff --git a/hugo/content/installation/install/linux/index.md b/hugo/content/installation/install/linux/index.md index a5f37852d2642d758dccafb36312a839014fb5be..470e6877cfeb10f31dacf1d4b11170f459f606e5 100644 --- a/hugo/content/installation/install/linux/index.md +++ b/hugo/content/installation/install/linux/index.md @@ -5,24 +5,29 @@ weight = 30 ## Install on Linux -BornAgain is available as a Debian/Ubuntu package at https://tracker.debian.org/pkg/bornagain. +There are three ways to install BornAgain on Linux: +- [building from source]({{% relref "installation/building/unix" %}}); +- using the Debian/Ubuntu package provided by external maintainers + at https://tracker.debian.org/pkg/bornagain; +- using the installer shell script described in the following. -A self-contained binary installer is also produced for the major Linux distributions -and their derivatives (like Debian, Ubuntu, ArchLinux, Manjaro, Fedora) and can be -downloaded as a GitLab artifact. -The installer includes all the libraries required for BornAgain, its Python package ('wheel'), -plus additional libraries and plugins for the GUI. Note that the GUI is known to work on the -[X11 graphics platform](https://en.wikipedia.org/wiki/X_Window_System), but Wayland is not -tested yet; if you are using a Wayland platform, please let us know about your experience -with BornAgain. +The BornAgain Linux installer can be downloaded from {{% url-releases %}}. +Under the present release, it is named `{{% recommended-linuxinstaller %}}`. + +The installer includes all the libraries required for BornAgain, its Python package ("wheel"), +plus additional libraries and plugins for the GUI. + +We have tested the GUI with the standard X11 window system. +If you are using the alternative Wayland window system, +please let us know about your experience. The installer is self-extracting and does _not_ need any root permissions. -The installer (e.g., `{{% recommended-linuxinstaller %}}`) can be used as follows -(here, installation root path is chosen to be `/tmp/ba`): +The installer can be used as follows +(here, installation root path is chosen to be `~/ba`): ``` $ chmod +x {{% recommended-linuxinstaller %}} # permit execution -$ ba_path='/tmp/ba' +$ ba_path='~/ba' $ mkdir $ba_path # make a deliberate installation path $ ./{{% recommended-linuxinstaller %}} --exclude-subdir --skip-license --prefix=$ba_path ``` @@ -32,12 +37,9 @@ $ cd $ba_path $ ./bin/bornagain ``` -The installer provides also a small help for its options; use the following to obtain -a description of the available options: +A description of available options can be displayed with ``` $ {{% recommended-linuxinstaller %}} --help ``` -For other distributions, see [build instructions]({{% relref "installation/building/unix" %}}). - {{% children %}}