Skip to main content

Linux Installation Guide {BETA}

Here's how you can now test Insightful on Linux

K
Written by Katarina Dakic

Insightful is available on Linux as well! This is, however, this is still in the beta testing stage, so in case you want to try it out, here's what you need to know.

The following features are currently not supported on Linux: Always Active (On call), VPN detection, synthetic input detection and Custom Plugin for a specific customer.

Supported and Unsupported versions

The following Linux distributions are supported for both Company and Personal computer versions:

  • Ubuntu 20.04 or later (all newer Ubuntu releases are supported)

  • Linux Mint 20 or later

  • Fedora 32 or later

Other distributions, including Debian, are not supported. On unsupported distributions or versions, the Insightful app may not start at all or may not work correctly.

Known issues: on Ubuntu 25.x, the Insightful app may not start after a Company computer installation. On Fedora 43, the latest agent version has a known issue. Fixes for both are in progress.

Important notes

  • Only the x86_64 (64-bit Intel/AMD) architecture is supported. 32-bit and ARM devices are not supported.

  • Supported desktop environments are GNOME and Cinnamon. Other desktop environments (such as KDE or XFCE) have not been tested.

  • The only supported display server is X11 (Xorg), for all distributions and versions. Make sure to set it up before installing Insightful on your computer as per the instructions in the image below (usually displayed as Xorg or X11).

  • Wayland is not supported. If you are using Wayland (the default on newer Ubuntu versions with GNOME), Insightful will not be able to detect the active window and URLs and will not capture screenshots. To resolve this, switch your display server to X11 by logging out, choosing the X11 session from the gear icon on the login screen, and logging back in. If your system does not offer an X11 session, please contact our support team.

You can always check which display server you are currently using by entering this command into a terminal: echo $XDG_SESSION_TYPE. If the command output does not specify x11, follow the steps provided in the important notes section to switch to the X11 display server for optimal functionality.

Company Computer Installation

For company computer users, please copy the script that is available to you on the Insightful dashboard when you click on the Add New Employee button → Company computers → Linux.

The installation script requires curl to be installed on the computer. If it is missing, install it first (e.g. sudo apt install curl on Ubuntu/Mint or sudo dnf install curl on Fedora).

Trigger the code by pasting the script into the Terminal and pressing Enter, and after the script installation is complete, you can start using Insightful (this lasts no more than 5 minutes).

​

Personal Computer Installation

The Personal computer agent is distributed as an AppImage, which requires libfuse2 to run. If it is missing, install it first (e.g. sudo apt install libfuse2 on Ubuntu/Mint, or libfuse2t64 on Ubuntu 24.04 and later; sudo dnf install fuse-libs on Fedora).

  1. Download the Insightful Personal Computer agent via the Insightful dashboard invitation.

  2. Right-click on the file and choose Properties.

3. On the Permissions tab, check the option Allow executing file as a program.

4. Exit the window and double-click on the AppImage file to finish the installation.

👉 Since Linux is still in beta, we're aware that some things may not work properly and we would like to get more feedback from you, so please contact our support team at support@insightful.io if you need help at any point and we will be more than glad to help you.

Did this answer your question?