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

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

# Sintoma observavel
- Plugin presente em `/home/glpi/glpi_dev/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`:
- `/home/glpi/glpi_dev/plugins/:/var/www/glpi/plugins`
- `/home/glpi/glpi_dev/files:/var/glpi/files`
- `/home/glpi/glpi_dev/config:/var/glpi/config`
- `/home/glpi/glpi_dev/marketplace/:/var/glpi/marketplace`

# Validacao padrao
Executar:
1. `docker compose up -d --force-recreate glpi`
2. `docker exec devportal_glpi ls -la /var/www/glpi/plugins`
3. `curl -s -o /dev/null -w "%{http_code}\n" http://localhost`

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.