1
0
Fork 0
docker-easy-haproxy/examples/docker/README.md
Joao Gilberto Magalhaes b9a9bee0b9 Revamp Swarm example documentation and streamline deployment instructions
- Consolidated and simplified Swarm example README to focus on YAML header comments for documentation.
- Removed redundant and extended sections, replacing with concise steps for getting started.
- Standardized YAML headers across `easyhaproxy.yml`, `services.yml`, and `portainer.yml` with a clearer and more readable format.
- Enhanced user guidance for deployment, setup requirements, verification, and cleanup.
2025-12-04 10:07:17 -05:00

3.3 KiB

Docker Compose Examples

Self-contained examples for EasyHAProxy. All documentation is in the docker-compose files as header comments.

Quick Start

  1. Pick an example below
  2. Open the docker-compose file
  3. Read the header comments for complete instructions
  4. Run the commands step-by-step

Basic Examples

File Description
docker-compose.yml Basic SSL setup with two virtual hosts and stats interface
docker-compose-acme.yml Let's Encrypt SSL with automatic certificate generation
docker-compose-multi-containers.yml Load balancing across multiple container replicas
docker-compose-changed-label.yml Using custom label prefix (for multiple EasyHAProxy instances)

Real-World Application Examples

File Description
docker-compose-portainer.yml Portainer behind EasyHAProxy with Let's Encrypt
docker-compose-portainer-app-example.yml Additional app alongside Portainer (shared network)

Plugin Examples

File Description
docker-compose-php-fpm.yml FastCGI plugin with PHP-FPM and PATH_INFO routing
docker-compose-jwt-validator.yml JWT token validation for API protection
docker-compose-ip-whitelist.yml IP whitelist for admin panels or sensitive services
docker-compose-cloudflare.yml Restore real client IPs when behind Cloudflare CDN
docker-compose-plugins-combined.yml Multiple plugins combined for layered security

Documentation Structure

Each docker-compose file contains:

  • WHAT THIS DEMONSTRATES - Key features and concepts
  • REQUIREMENTS - Idempotent setup commands (safe to run multiple times)
  • HOW TO START - Command to launch the stack
  • HOW TO VERIFY IT'S WORKING - Test commands with expected outputs
  • CLEAN UP - Commands to stop and remove resources

Additional Documentation