## Install McXtrace 3.5.1 On Debian class systems (including Ubuntu, mint etc.):
The packages have been tested to work correctly on Ubuntu 22.04 and Debian 11.

# Add the McCode repository
After following the below steps your package manager should now be aware of mcxtrace
```bash
cd /etc/apt/sources.list.d
sudo wget https://packages.mccode.org/debian/mccode.list
sudo apt-get update
```

# Debian only:
On Debian you will further have to install the non-free repository to have access to all McXtrace tool parts. See https://wiki.debian.org/SourcesList

# Look for McXtrace packages to install
```bash
mcxtrace@debian:~$ apt-cache search mcxtrace | grep -v 2.
mcxtrace-3.5.1 - mcxtrace built using CMake
mcxtrace-comps-3.5.1 - mcxtrace-comps built using CMake
mcxtrace-manuals-3.5.1 - mcxtrace_manuals built using CMake
mcxtrace-suite - A metapackage for McXtrace + perl and python tools
mcxtrace-suite-python - A metapackage for McXtrace + python tools
mcxtrace-tools-matlab-mcplot-3.5.1 - matlab-tools-mcplot built using CMake
mcxtrace-tools-python-mccodelib-3.5.1 - python-tools-mccodelib built using CMake
mcxtrace-tools-python-mcdisplay-mantid-3.5.1 - python-tools-mcdisplay-mantid built using CMake
mcxtrace-tools-python-mcdisplay-pyqtgraph-3.5.1 - python-tools-mcdisplay-pyqtgraph built using CMake
mcxtrace-tools-python-mcdisplay-webgl-3.5.1 - python-tools-mcdisplay-webgl built using CMake
mcxtrace-tools-python-mcgui-3.5.1 - python-tools-mcgui built using CMake
mcxtrace-tools-python-mcplot-pyqtgraph-3.5.1 - python-tools-mcplot-pyqtgraph built using CMake
mcxtrace-tools-python-mcrun-3.5.1 - python-tools-mcrun built using CMake
```
The meta-package mcxtrace-suite-python
allows you to install mcxtrace 3.5.1 with one or both sets of tools (mcrun/mcplot etc.) by simple apt-get commands like
```bash
sudo apt-get install mcxtrace-suite-python
```
The -suite packages without 'ng' in the package name will install the
latest McXtrace 2.x package

# Using mcdoc on modern Ubuntu systems
Ubuntu is shipping its browsers as "snap" packages, meaning that they
are blocked from accessing e.g. the McXtrace html snippets in
/usr/share/mcxtrace/3.5.1/.

To fix this we propose to switch your browser to a proper apt based
installation, in this example firefox:

Remove the snap-based firefox:
```
sudo snap remove firefox
```
Add the official mozilla-built firefox instead:
```
sudo add-apt-repository ppa:mozillateam/ppa
```
Set priorities to always prefer this firefox package:
```
echo '
Package: *
Pin: release o=LP-PPA-mozillateam
Pin-Priority: 1001
' | sudo tee /etc/apt/preferences.d/mozilla-firefox
```
Set up unattended upgrades of firefox
```
echo 'Unattended-Upgrade::Allowed-Origins::
"LP-PPA-mozillateam:${distro_codename}";' | sudo tee
/etc/apt/apt.conf.d/51unattended-upgrades-firefox
```
Finally, install firefox from the mozilla-channels
```
sudo apt install firefox
```

# Optionals
Optionally install iFit to visualize results using a Matlab environment (for free, no license needed).
Optionally install a VRML/X3D plotter such as Freewrl or InstantReality.
Optionally, you can install the NeXus format libraries to be able to export data files in HDF5.
Please report any trouble with the repository to [mcxtrace-users](mailto:mcxtrace-users@mcxtrace.org)

# Installing without adding the repo
If you want to attempt installing our debian packages manually via
dpkg, the packages are available for download at https://download.mcxtrace.org/mcxtrace-3.5.1/linux/debian/
(available for multiple processor architectures).

## In case of issues
Please report any trouble with the repository to [mcxtrace-users](mailto:mcxtrace-users@mcxtrace.org)