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.4-x86_64.AppImage sudo ./glpi-agent-1.4-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
To upgrade the agent if you still installed glpi-agent linux appimage, just run:
chmod +x glpi-agent-1.4-x86_64.AppImage sudo ./glpi-agent-1.4-x86_64.AppImage --upgrade
By default, the agent is installed under
/usr/local/bin and dedicated configuration is created under
To uninstall the agent, you simply can run:
Or to also clean any data in
sudo glpi-agent-uninstall --clean
You can retrieve all available parameters running:
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.
PATHas installation folder. (By default:
Try to just upgrade the currently installed agent, keeping configuration and trying to restart the agent.
Like upgrade but involves
--cleanoption to make a clean install, resetting the configuration.
Try to uninstall currently installed Glpi Agent AppImage.
When installing, copy the given configuration file in
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).
SCHEDcan only be set to
Output the installer version and exit.
Make installer silent.
Output help and exit.
Run embedded script in place of installer.
Run embedded perl.
Most importantly, at least one target definition option is mandatory when installing GLPI Agent.
Task selection options
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
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
Web interface options
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:
This will extract the content into a
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
AppRunfrom 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
It is possible to use AppImage installer to create a portable linux glpi agent environment.
Here are the step to install such environment:
Download a GLPI Agent AppImage
Copy script and AppImage to a dedicated folder, for example at the root of an USB key or a network shared folder
Make script and AppImage executable with:
sudo chmod +x glpi-agent-portable.sh glpi-agent*.AppImage
Run one time
glpi-agent-portable.shto setup the environment. This will create a
var/subfolder and all scripts at the same level. Don't remove
etc/conf.gto 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:
Remove old AppImage from the folder
Download and copy the newer AppImage
Make AppImage executable
sudo chmod +x glpi-agent*.AppImage