From 1d1b448e1892eba1ec0e3384b1361d6352e1d85d Mon Sep 17 00:00:00 2001 From: Axel Kohlmeyer Date: Sun, 4 Aug 2024 06:34:07 -0400 Subject: [PATCH] update Linux installation docs to describe flatpak installation --- doc/src/Howto_lammps_gui.rst | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/src/Howto_lammps_gui.rst b/doc/src/Howto_lammps_gui.rst index 06c2d1436e7..a408272ae93 100644 --- a/doc/src/Howto_lammps_gui.rst +++ b/doc/src/Howto_lammps_gui.rst @@ -98,10 +98,26 @@ get access to the other included executables. Linux on x86\_64 ^^^^^^^^^^^^^^^^ -After downloading and unpacking the +For Linux with x86\_64 CPU there are currently two variants. The first +is compiled on Ubuntu 20.04LTS, is using some wrapper scripts, and +should be compatible with more recent Linux distributions. After +downloading and unpacking the ``LAMMPS-Linux-x86_64-GUI-.tar.gz`` package. You can switch into the "LAMMPS_GUI" folder and execute "./lammps-gui" directly. +The second variant uses `flatpak `_ and +requires the flatpak management and runtime software to be installed. +After downloading the ``LAMMPS-GUI-Linux-x86_64-GUI-.tar.gz`` +flatpak bundle, you can install it with ``flatpak install --user +LAMMPS-GUI-Linux-x86_64-GUI-.tar.gz``. After installation, +LAMMPS-GUI should be integrated into your desktop environment under +"Applications > Science" but also can be launched from the console with +``flatpak run org.lammps.lammps-gui``. The flatpak bundle also includes +the console LAMMPS executable ``lmp`` which can be launched to run +simulations with, for example: ``flatpak run --command=lmp +org.lammps.lammps-gui -in in.melt``. + + Compiling from Source ^^^^^^^^^^^^^^^^^^^^^