#rev 2023-04-18 stroth
= ISG D-ITET managed laptops software installation =

== Software installation ==

Specific software is already preinstalled, some has to be installed by the user:

||'''Software Name'''||<:>'''Preinstalled'''||<:>'''User installation'''||
|| 3D Slicer                  ||<:>M      ||                   ||
|| bartview/bart              ||<:>S      ||                   ||
|| Chrome                     ||<:>3      ||                   ||
|| conda                      ||<:>3      ||                   ||
|| Draw.io                    ||<:>M      ||                   ||
|| Element Desktop            ||<:>3      ||                   ||
|| Fiji ImageJ                ||              ||<:>M           ||
|| Firefox                    ||<:>3      ||                   ||
|| Freesurfer/FreeView        ||<:>M      ||                   ||
|| ITK Snap                   ||<:>M      ||                   ||
|| kdevelop                   ||<:>S      ||                   ||
|| Mathematica                ||<:>M      ||                   ||
|| Matlab                     ||<:>M      ||                   ||
|| Meshlab                    ||              ||<:>F/S         ||
|| Meld                       ||<:>S      ||                   ||
|| !OwnCloud (Polybox) Client  ||<:>3      ||                   ||
|| Protégé Desktop            ||              ||<:>M           ||
|| !PyCharm Pro                ||              ||<:>F/S         ||
|| SETT                       ||              ||<:>C/P         ||
|| Signal Desktop             ||<:>3      ||                   ||
|| !SublimeText                ||<:>3      ||                   ||
|| Thunderbird                ||<:>3      ||                   ||
|| Visual Studio Code         ||<:>3      ||                   ||
|| Zoom                       ||              ||<:>F/S         ||
|| Zotero                     ||              ||<:>F/S         ||

 * '''Fiji ImageJ''' is a Java application which can be [[https://downloads.imagej.net/fiji/latest/fiji-linux64.zip|downloaded]], extracted and run by every user.
 * '''Protégé Desktop''' is a Java application which can be [[https://protege.stanford.edu/products.php#desktop-protege|downloaded]], extracted and run by every user.
 * '''SETT''' has an manual for its [[https://sett.readthedocs.io/en/latest/installation.html|installation]] with conda or pip
 * The '''Teams''' Linux application is not maintained anymore, the recommended alternative is to run the official web application by opening [[https://teams.microsoft.com|teams.microsoft.com]] in Chrome. We provided a wrapper to present this like any other application.
 * Other requested software like '''!LibreOffice''' is part of the default installation of Ubuntu

=== Preinstalled ===

 * '''M''': Manually packaged and installed by ISG D-ITET
 * '''S''': from standard repos
 * '''3''': from 3rd party repos

=== User installation ===

This is the requested software you are supposed to install yourself.

 * '''M''': Manual installation, i.e. download and extract the downloaded archive
 * '''F/S''': available as flatpak/snap
 * '''C/P''': available as conda/pip package

You are permitted to install, unistall and update software to support your personal requirements.

3 different public sources for software packages are available:

 * '''deb''' packages from installed standard and 3rd party repositories
 * '''flatpaks''' from [[https://flathub.org/|Flathub]]
 * '''snaps''' from the Ubuntu [[https://snapcraft.io/store|Snapcraft store]]

The software you are looking to install may be available in more than one source, where each source can contain a different release version of the software and the quality of the package may differ between sources as well.

The rule of thumb is to always use '''deb''' packages if the version they provide is sufficient for you. Otherwise you have to try out which source delivers the package which works for you.

Copy downloadable third-party '''deb''' packages to `/srv/local-apt-repository/` and run `sudo apt-get update` to make them available like any other package.

==== Install example with the desktop application ====

 1. Open the application labelled '''Software''' (`gnome-software` on the command line)
 2. Type `meshlab` in the search field opened by the magnifying glass icon 🔍
 3. For each result: check its detail page for version numbers, check sources by clicking on the text below the button labelled '''Install'''

You will see different versions from different sources and will have to choose which one to install by clicking on the '''Install''' button.

==== Install example from the command line ====

Each source uses a different search command:

||'''Source'''||'''Search Command'''||'''Install Name or ID'''||'''Version'''||
|| deb     || `apt search meshlab`     || meshlab/kinetic     || 2020.09+dfsg1-2    ||
|| flatpak || `flatpak search meshlab` || net.meshlab.!MeshLab || 2022.02            ||
|| snap    || `snap search meshlab`    || meshlab-mardy       || 2016.12-20170302-3 ||

Each source uses a different install command and installs either by package name or ID:

||'''Source'''||'''Install Command'''||
|| deb     || `apt install meshlab`                 ||
|| flatpak || `flatpak install net.meshlab.MeshLab` ||
|| snap    || `snap install meshlab-mardy`          ||