knowledge-base/records/infrastructure/KB-INFRA-001-glpi-plugin-path.md

id	title	domain	tags	status	severity	created_at	updated_at	applies_to	related_records
KB-INFRA-001	Caminho correto de plugins no container GLPI oficial	infrastructure	glpi docker plugins mount orbstack	active	high	2026-05-01	2026-05-01	glpi/glpi:latest macOS + OrbStack ambiente local de desenvolvimento

Contexto

O plugin GLPI Matrix nao era exibido na interface do GLPI, mesmo existindo no host e no container.

Sintoma observavel

• Plugin presente em docker/glpi/plugins/glpimatrix.
• Interface de plugins do GLPI nao listava o plugin.

Causa raiz

O bind mount estava apontando para caminho incorreto do container:

• Incorreto: /var/www/html/glpi/plugins
• Correto (nesta imagem): /var/www/glpi/plugins

A imagem glpi/glpi:latest usada neste projeto executa o core em /var/www/glpi.

Correcao aplicada

No docker-compose.yml, atualizar volumes do servico glpi:

• ./docker/glpi/plugins:/var/www/glpi/plugins
• ./docker/glpi/files:/var/glpi/files
• ./docker/glpi/config:/var/glpi/config
• ./docker/glpi/marketplace:/var/glpi/marketplace

Validacao padrao

Executar:

1. docker compose up -d --force-recreate glpi
2. docker exec glpi11-app ls -la /var/www/glpi/plugins
3. curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8081

Esperado:

• diretorio do plugin visivel em /var/www/glpi/plugins;
• HTTP 200;
• plugin listavel em Configuracao > Plugins apos refresh.

Impacto

• Sem essa correcao, agentes podem interpretar incorretamente que o plugin esta invalido.
• O problema e de infraestrutura/container path, nao de logica do plugin.

Regra para agentes

Antes de diagnosticar erro funcional de plugin, validar:

1. caminho de mount do plugin;
2. estrutura interna da imagem em uso;
3. cache e estado do container.

Classificacao

• Tipo: Licao aprendida de infraestrutura.
• Reutilizacao: obrigatoria em novos setups locais GLPI.