Linux AppImage Installer

Linux AppImage installer is another way to install glpi-agent on linux. It has the advantage to work on any linux supporting AppImage format (most linux distros since years).

To install the agent, just run:

chmod +x glpi-agent-1.7-x86_64.AppImage
sudo ./glpi-agent-1.7-x86_64.AppImage --install --server <URL>

At this point, if you obtain an error explaining AppImages require FUSE to run., you still can try a manual install.


On Ubuntu, starting with Ubuntu 22.04, fuse3 is installed, but AppImage requires libfuse2. So you should install it with:

sudo apt install libfuse2


As reported by MarcSamD, if you have a message telling is missing, you will need to install a compatibility package providing that library. On RPM based distro, you probably just need to install libxcrypt-compat package.

To upgrade the agent if you still installed glpi-agent linux appimage, just run:

chmod +x glpi-agent-1.7-x86_64.AppImage
sudo ./glpi-agent-1.7-x86_64.AppImage --upgrade

By default, the agent is installed under /usr/local/bin and dedicated configuration is created under /etc/glpi-agent/conf.d.

To uninstall the agent, you simply can run:

sudo glpi-agent-uninstall

Or to also clean any data in /etc/glpi-agent and /var/lib/glpi-agent:

sudo glpi-agent-uninstall --clean

Installer parameters


You can retrieve all available parameters running:

./glpi-agent-1.7-x86_64.AppImage --help

Install the agent by coping AppImage to install path, creating binding scripts for GLPI Agent commands. It copies default configurations and creates dedicated configuration to setup the agent with configuration parameters.

-i --installpath=PATH

Define PATH as installation folder. (By default: /usr/local/bin)


Try to just upgrade the currently installed agent, keeping configuration and trying to restart the agent.


Like upgrade but involves --clean option to make a clean install, resetting the configuration.


Try to uninstall currently installed Glpi Agent AppImage.


When installing, copy the given configuration file in /etc/glpi-agent/conf.d


Clean everything when uninstalling or before installing.


Run agent tasks after installation.


Install GLPI Agent AppImage as a service. This option is selected by default.


Don't install GLPI Agent as a service.


Install agent as cron task (no by default). SCHED can only be set to daily or hourly.


Output the installer version and exit.

-S --silent

Make installer silent.

-h --help

Output help and exit.


Run embedded script in place of installer.


Run embedded perl.

Configuration parameters

All configuration options are documented in Configuration page and in the glpi-agent man page.

Target options

Most importantly, at least one target definition option is mandatory when installing GLPI Agent.

-s --server=URI

send tasks result to a server

-l --local=PATH

write tasks results locally in a file

Scheduling options


maximum delay before running target tasks the first time


do not contact the target before next scheduled time

Task selection options


do not run given task


run given tasks in given order

Inventory task specific options


do not include given categories in inventory


scan user home directories


scan user profiles


save inventory as HTML


save inventory as JSON


always send data to server


timeout for inventory modules execution

Remote inventory task specific options


setup remote for which request remote inventory

Deploy task specific options


do not use peer to peer to download files

Network options


proxy address


user name for server authentication


password for server authentication


CA certificates directory


CA certificate file


Client certificate file


Fingerprint of SSL certificate to trust


do not check server SSL certificate

-C --no-compression

do not compress communication with server


connection timeout

Web interface options


disable embedded web server


local network ip to listen on


network port to listen on


trust given IPs and IP ranges


enable listener target if required

Logging options


logger backend


log file


maximum size of the log file


syslog facility


use color in the console


enable debug mode

General options


number of seconds between two configuration reloading

-t --tag=TAG

add given tag to inventory results


use specified path as storage folder for agent persistent datas

Manual install

In the case, FUSE is not installed on the system and you can't or don't want to install it, you still can install GLPI Agent manually by following these steps:

  • Extract AppImage content:

    ./glpi-agent-1.7-x86_64.AppImage --appimage-extract

    This will extract the content into a squashfs-root subfolder.

  • Copy the squashfs-root folder to a dedicated place:

    [ -d /opt ] || sudo mkdir /opt
    sudo rm -rf /opt/glpi-agent
    sudo cp -r squashfs-root /opt/glpi-agent
  • Run the AppRun from copied folder as installer:

    sudo /opt/glpi-agent/AppRun --install --server <URL>

To uninstall after a manual install, you need to run:

sudo /usr/local/bin/glpi-agent-uninstall
sudo rm -rf /opt/glpi-agent

Portable installation

It is possible to use AppImage installer to create a portable linux glpi agent environment.


Here are the step to install such environment:

  1. Download

  2. Download a GLPI Agent AppImage

  3. Copy script and AppImage to a dedicated folder, for example at the root of an USB key or a network shared folder

  4. Make script and AppImage executable with:

    sudo chmod +x glpi-agent*.AppImage
  5. Run one time to setup the environment. This will create a etc/ and a var/ subfolder and all scripts at the same level. Don't remove and AppImage.

    sudo ./
  6. Create a .cfg file under etc/conf.g to configure your agent or create dedicated script which start expected glpi-agent scripts with expected parameters.

You're now ready to use the linux portable agent.


As installed scripts are using --vardir=PATH option, agent deviceid will be defined depending on the current computer hostname. So you can safely run it on different computers. The deviceid will even be reused later if you run it again on a given computer.


You can also specify AppImage to use by defining APPIMAGE environment variable.


It is really simple to upgrade a portable installation:

  1. Remove old AppImage from the folder

  2. Download and copy the newer AppImage

  3. Make AppImage executable

    sudo chmod +x glpi-agent*.AppImage