- 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.
3.3 KiB
3.3 KiB
Docker Compose Examples
Self-contained examples for EasyHAProxy. All documentation is in the docker-compose files as header comments.
Quick Start
- Pick an example below
- Open the docker-compose file
- Read the header comments for complete instructions
- 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