Skip to main content

6. Troubleshooting

I see "Check API connection" in red

The plugin could not use the key. Check, in this order: the key is a valid BorgBase key; the Server endpoint is an https address; and GLPI can reach it (a proxy configured in GLPI is used). If the endpoint is on a private network address, GLPI blocks the request until you allow it: add 'GlpiPlugin\\Borgbase\\Config' to GLPI_SERVERSIDE_URL_ALLOWED_PRIVATE_NETWORKS_CONTEXTS in config/local_define.php, keeping Agent and Auth. Errors are written to the borgbase log.

The key disappeared after I changed the endpoint

Changing the Server endpoint clears the saved key, so it is never sent to a server it was not entered for. Type the key again and save.

A computer was not linked to its repository

The names must be exactly the same, upper and lower case included; only the spaces at both ends are ignored. Also check that Computer name matches exactly with repository name is Yes, that the repository is not already linked to another computer, and that the computer is not in the trash or a template. Computers that were created after the key was saved are linked when you open their Borgbase tab, or with Link repositories in the settings.

The Borgbase tab is not on a computer

It needs the Read level of the Borgbase right in your profile. Computer templates never show it.

I cannot reload, link or unlink

Besides the matching level of the Borgbase right (Update, Create or Purge), you need the right to update the computer, in its entity. Without it the buttons are not shown.

The data is out of date

The data is a copy, refreshed once a day by the borgbaseUpdate automatic action, which runs in CLI mode, so GLPI's cron must be set up. Use Reload information on the computer, or Execute on the automatic action, to refresh it now.

The dashboard cards show zero or nothing

The cards need the Read level of the right, a working connection and, for the usage cards, a BorgBase account that reports its usage. Number of Computers with a Repo Linked counts only the computers of your active entities.

Generated for Borgbase 3.0.0 on GLPI 12.0.2 — 2026-11-20.