Running the client as Flatpak

General information

Starting with Axxon One 2.0.10, you can use Flatpak to run the client in Linux OS. This package allows you to run the Axxon One client on any supported Linux distribution, regardless of the operating system version, graphical shell, and so on (see the current list of supported distributions).

Installation of Flatpak

To install Flatpak, do the following:

1. Download the package by running the command:
   

   sudo apt-get install flatpak

   For the Red Hat Enterprise Linux distribution, run the command:
   

   sudo yum install flatpak

2. Add the Flathub repository:
   

   sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

3. Install org.freedesktop.Platform:
   

   sudo flatpak install flathub org.freedesktop.Platform/x86_64/20.08

4. Install the Axxon One client:
   

   sudo flatpak install axxon-one-client*.flatpak

Installation of Flatpak is complete.

Running Flatpak

To start Flatpak, run the command:

flatpak run com.AxxonSoft.AxxonOne

Viewing the installed applications

To view all installed applications via Flatpak, run the command:

flatpak list

You can also use this command to check if Flatpak is installed/uninstalled.

Utilities and logging

Running Axxon One with the debug logging level

flatpak run com.AxxonSoft.AxxonOne --debug

Navigating to the directory with logs

~/.var/app/com.AxxonSoft.AxxonOne/data/AxxonSoft/AxxonOne/Logs

Running the licensing utility

flatpak run com.AxxonSoft.AxxonOne --licensetool

Running the backup utility

flatpak run com.AxxonSoft.AxxonOne --backuptool

Path to the backup file: /home/user/AxxonSoft/Backups.

Collect a file with information about the system

flatpak run com.AxxonSoft.AxxonOne --support /path/to/output

Possible problems in operation

1. If Axxon One doesn’t start after you install Flatpak, you can run the command:
   

   flatpak repair com.AxxonSoft.AxxonOne

   This command checks installed files and fixes errors in Flatpak apps, updates dependencies, fixes permission errors, and can also detect configuration errors.
2. If Axxon One runs with the error System.TypeInitializationException trying to get all screens: The type initializer for 'System.Windows.Forms.XplatUI' threw an exception, you can run the following commands to fix it:
   

   Attention!

   You must run the command under the current user (not as the root user).

   flatpak override --user com.AxxonSoft.AxxonOne --socket=x11
   flatpak override --user com.AxxonSoft.AxxonOne --socket=wayland

   
   

Uninstalling Flatpak

To uninstall Flatpak, do the following:

1. Uninstall com.AxxonSoft.AxxonOne:
   

   flatpak uninstall com.AxxonSoft.AxxonOne

   After you run the command, the system can ask you to confirm the uninstallation. If unused dependencies are detected during the process, you will be prompted to uninstall them as well.
2. If necessary, you can uninstall all unused dependencies with the command:
   

   Attention!

   Before you run the command, check if Axxon One is stopped (see Starting and stopping the Axxon One Server in Linux OS).

   flatpak uninstall --unused

Uninstalling Flatpak is complete.