Skip to content
Snippets Groups Projects
Commit 25c545de authored by Wuttke, Joachim's avatar Wuttke, Joachim
Browse files

revise Linux instructions

parent 5698b29a
No related branches found
No related tags found
2 merge requests!1511changes from r20.0,!1509Revise installation instructions; revise hugo config params; use shortcodes for URLs; repair broken links
...@@ -5,24 +5,29 @@ weight = 30 ...@@ -5,24 +5,29 @@ weight = 30
## Install on Linux ## 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 The BornAgain Linux installer can be downloaded from {{% url-releases %}}.
and their derivatives (like Debian, Ubuntu, ArchLinux, Manjaro, Fedora) and can be Under the present release, it is named `{{% recommended-linuxinstaller %}}`.
downloaded as a GitLab artifact.
The installer includes all the libraries required for BornAgain, its Python package ('wheel'), 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 plus additional libraries and plugins for the GUI.
[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 We have tested the GUI with the standard X11 window system.
with BornAgain. 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 is self-extracting and does _not_ need any root permissions.
The installer (e.g., `{{% recommended-linuxinstaller %}}`) can be used as follows The installer can be used as follows
(here, installation root path is chosen to be `/tmp/ba`): (here, installation root path is chosen to be `~/ba`):
``` ```
$ chmod +x {{% recommended-linuxinstaller %}} # permit execution $ chmod +x {{% recommended-linuxinstaller %}} # permit execution
$ ba_path='/tmp/ba' $ ba_path='~/ba'
$ mkdir $ba_path # make a deliberate installation path $ mkdir $ba_path # make a deliberate installation path
$ ./{{% recommended-linuxinstaller %}} --exclude-subdir --skip-license --prefix=$ba_path $ ./{{% recommended-linuxinstaller %}} --exclude-subdir --skip-license --prefix=$ba_path
``` ```
...@@ -32,12 +37,9 @@ $ cd $ba_path ...@@ -32,12 +37,9 @@ $ cd $ba_path
$ ./bin/bornagain $ ./bin/bornagain
``` ```
The installer provides also a small help for its options; use the following to obtain A description of available options can be displayed with
a description of the available options:
``` ```
$ {{% recommended-linuxinstaller %}} --help $ {{% recommended-linuxinstaller %}} --help
``` ```
For other distributions, see [build instructions]({{% relref "installation/building/unix" %}}).
{{% children %}} {{% children %}}
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment