Skip to content

README.md

Latest commit

 

History

History
247 lines (185 loc) · 7.32 KB

README.md

File metadata and controls

247 lines (185 loc) · 7.32 KB
Raw

🐳 LEMP Stack + Zabbix Agent2

Docker Ubuntu PHP Nginx MySQL Zabbix License

Complete LEMP development environment in Docker with Zabbix Agent2 7.4 for monitoring tests and PHP application development.

✨ Features

  • 🏗️ Complete LEMP Stack - Ubuntu 24.04, Nginx, PHP 8.3, MySQL 8.0
  • 📊 Zabbix Agent2 7.4 - Advanced monitoring from official repository
  • 🚀 Quick Start - One command to bring up the entire stack
  • 🔧 No Supervisor - Native systemd services for maximum simplicity
  • 🌐 Alternative Ports - Compatible with Laravel Herd on macOS
  • 📱 Web Dashboard - Testing interface with service status
  • 💾 MySQL Persistence - Data preserved between restarts
  • 🐛 Integrated Debugging - Built-in logs and diagnostic tools

🚀 Quick Start

# Clone/access project directory
cd /path/to/project

# Copy environment configuration (optional)
cp env.example .env

# Build and start the stack
docker-compose up --build

# Or run in background
docker-compose up --build -d

Web Access: http://localhost:8081 (o el puerto configurado en NGINX_HTTP_PORT)

📋 Requirements

  • Docker and Docker Compose
  • Available ports: 8081, 8444, 3307, 10050 (configurables via variables de entorno)
  • (Optional) Zabbix Server running on localhost:10051

🏗️ Architecture

Included Stack:

  • Ubuntu 24.04 with native systemd
  • Nginx 1.24.0 (port 8081)
  • PHP 8.3-FPM with common extensions
  • MySQL 8.0 (port 3307)
  • Zabbix Agent2 7.4 (port 10050)

Port Mapping (configurable via variables de entorno):

  • ${NGINX_HTTP_PORT:-8081} → Nginx HTTP (avoids conflict with Herd:80)
  • ${NGINX_HTTPS_PORT:-8444} → Nginx HTTPS (avoids conflict with Herd:443)
  • ${MYSQL_PORT:-3307} → MySQL (avoids conflict with Herd:3306)
  • ${ZABBIX_AGENT_PORT:-10050} → Zabbix Agent

🛠️ Useful Commands

Stack Management

# Start services
docker-compose up -d

# View logs in real time
docker-compose logs -f

# Stop services
docker-compose down

# Rebuild from scratch
docker-compose down && docker-compose up --build

# Access container
docker exec -it lemp-zabbix-test bash

Service Management (inside container)

# Service status
docker exec lemp-zabbix-test service nginx status
docker exec lemp-zabbix-test service php8.3-fpm status
docker exec lemp-zabbix-test service mysql status
docker exec lemp-zabbix-test service zabbix-agent2 status

# Restart services
docker exec lemp-zabbix-test service nginx restart
docker exec lemp-zabbix-test service mysql restart
docker exec lemp-zabbix-test service zabbix-agent2 restart

Debugging

# View service logs
docker exec lemp-zabbix-test tail -f /var/log/nginx/error.log
docker exec lemp-zabbix-test tail -f /var/log/zabbix/zabbix_agent2.log

# Test Zabbix configuration
docker exec lemp-zabbix-test zabbix_agent2 -t

# Connect to MySQL
docker exec lemp-zabbix-test mysql -u testuser -ptestpass testdb

📁 Project Structure

/
├── docker-compose.yml          # Main orchestration
├── Dockerfile                  # LEMP stack image
├── nginx/default.conf          # Nginx configuration
├── zabbix/zabbix_agent2.conf  # Zabbix configuration
├── scripts/init.sh            # Initialization script
├── www/                       # Web files
│   ├── index.php             # Main dashboard
│   ├── test-mysql.php        # Detailed MySQL test
│   └── phpinfo.php           # PHP information
├── logs/                      # Application logs
└── mysql/data/               # Persistent MySQL data

🔧 Configuration

Variables de Entorno

Copia env.example a .env y modifica los valores según tus necesidades:

cp env.example .env

MySQL (configurable via variables de entorno)

  • Root: ${MYSQL_USER:-root} / ${MYSQL_ROOT_PASSWORD:-root123}
  • User: ${MYSQL_USER:-testuser} / ${MYSQL_PASSWORD:-testpass}
  • Database: ${MYSQL_DATABASE:-testdb}

Zabbix Agent2 (configurable via variables de entorno)

  • Server: ${ZABBIX_SERVER:-host.docker.internal} (your Mac)
  • Port: ${ZABBIX_SERVER_PORT:-10051} (server) / ${ZABBIX_AGENT_PORT:-10050} (agent)
  • Hostname: lemp-test-host

🌐 Test Pages

🔍 Troubleshooting

Container won't start

# View detailed logs
docker-compose logs

# Check ports in use (reemplaza 8081 con tu puerto configurado)
lsof -i :8081
lsof -i :10050  # Verificar puerto Zabbix Agent

MySQL won't connect

# Check status
docker exec lemp-zabbix-test service mysql status

# Reinitialize data (CAUTION: deletes data)
docker-compose down
rm -rf mysql/data/*
docker-compose up --build

Zabbix Agent not working

# Check configuration
docker exec lemp-zabbix-test zabbix_agent2 -t

# View logs
docker exec lemp-zabbix-test tail -f /var/log/zabbix/zabbix_agent2.log

Permission errors

# Restart with clean permissions
docker-compose down
docker system prune -f
docker-compose up --build

🎯 Purpose

This environment is designed for:

  • LEMP development testing
  • Zabbix configuration testing
  • PHP application development
  • Application monitoring and metrics

Note: This is a development/testing environment, not for production.

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

🐛 Report Issues

If you find a bug or have a suggestion:

  1. Check that a similar issue doesn't exist
  2. Open a new issue with detailed description
  3. Include steps to reproduce the problem
  4. Attach relevant logs if possible

📝 Technical Notes

  • Architecture: Native Ubuntu systemd services (no supervisor)
  • Persistence: MySQL data in ./mysql/data/
  • Networking: Host networking for Zabbix server compatibility
  • Configuration: Optimized for development and testing
  • Compatibility: Designed for macOS with Laravel Herd

📋 Roadmap

  • HTTPS support with self-signed certificates
  • Optional included Zabbix server configuration
  • MySQL backup/restore scripts
  • Additional monitoring with Prometheus
  • Docker multi-stage builds for optimization

📄 License

This project is under the GNU General Public License v3.0. See the LICENSE file for details.

👨‍💻 Author

Developed with ❤️ for the PHP development and DevOps community.

⭐ If this project was useful to you, give it a star! ⭐