Skip to content

docs: add operations guide for system administrators#279

Open
rafaelfariasbsb wants to merge 1 commit intoglpi-project:mainfrom
rafaelfariasbsb:docs/comprehensive-documentation
Open

docs: add operations guide for system administrators#279
rafaelfariasbsb wants to merge 1 commit intoglpi-project:mainfrom
rafaelfariasbsb:docs/comprehensive-documentation

Conversation

@rafaelfariasbsb
Copy link

Summary

Add docs/architecture.md as a practical operations guide for system administrators deploying and operating GLPI with Docker.

This is a reworked version of #278, scoped down based on maintainer feedback to focus strictly on what sysadmins can configure.

What's Covered

  • Environment variables reference (database, installation control, cron, paths)
  • Volume structure and data persistence (named volumes vs bind mounts)
  • Startup behavior overview
  • Scheduled jobs — how to add custom jobs via Supervisor
  • Log files and Docker logging configuration
  • PHP and Apache customization
  • Reverse proxy setup (Nginx and Traefik examples)
  • Backup and restore procedures
  • Security considerations (credentials, network isolation)
  • Horizontal scaling (separating web and cron workloads)
  • Troubleshooting common issues

What's NOT included

  • No changes to README.md
  • No Dockerfile internals, build stages, or script source code
  • No CI/CD pipeline documentation
  • No supporting/development image documentation

Refs #277

Add docs/architecture.md as a practical reference for sysadmins
deploying and operating GLPI with Docker. Covers environment
variables, volumes, scheduled jobs, logs, PHP/Apache configuration,
reverse proxy setup, backup/restore, security, and troubleshooting.

Refs glpi-project#277
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants