Docker Compose

Zenithal provides a powerful visual interface for Docker Compose projects. Import existing projects or create new ones with pre-deployment validation and background deployment tracking.

Add an existing Compose project to Zenithal:

1. Go to Compose in the sidebar
2. Click Import Project
3. Select the folder containing your docker-compose.yml
4. Zenithal will automatically detect and parse the configuration

The visual Compose Builder lets you create multi-service configurations without writing YAML:

1. Click Create New to open the Compose Builder window
2. Add services with a visual interface
3. Configure images, ports, volumes, environment variables, and networks
4. Add optional startup scripts for service initialization
5. Preview the smart-generated YAML with intelligent defaults
6. Deploy directly or save the file

Before deploying, Zenithal validates your configuration and warns about potential issues:

• Port Conflicts - Detects if ports are already in use by other containers or system services
• Image Availability - Checks if images exist locally or can be pulled
• Volume Paths - Validates that host paths exist and are accessible
• Network Configuration - Ensures networks are valid and compatible
• Environment Variables - Warns about missing required variables
• Syntax Errors - Catches YAML syntax issues before deployment

Zenithal supports background deployments so you can continue working while services start:

1. Review validation results
2. Click Deploy (or Up)
3. Watch real-time progress in the background deployment panel
4. Each service shows: Pulling → Creating → Starting → Running

Deployment Options

• Recreate - Force recreate containers even if unchanged
• Pull - Always pull latest images before deploying
• Build - Rebuild images from Dockerfile
• Remove Orphans - Remove containers not defined in Compose file

Visualize your service architecture with the interactive dependency graph:

• Services shown as nodes with health status colors
• Dependency arrows between services (from depends_on)
• Port mappings displayed on each service
• Click a service to view details or open logs
• Drag to rearrange, scroll to zoom

Scale services up or down without editing the Compose file:

1. Right-click a service in the project view
2. Select Scale
3. Enter the desired number of replicas
4. Zenithal will start or stop containers to match

Zenithal tracks changes to your Compose files:

• View history of all deployments
• See diff between versions
• Rollback to a previous configuration
• Compare current vs deployed configuration

Quickly spin up common stacks with built-in templates:

• LAMP (Linux, Apache, MySQL, PHP)
• MEAN (MongoDB, Express, Angular, Node)
• WordPress + MySQL
• PostgreSQL + pgAdmin
• Redis + Redis Commander
• Elasticsearch + Kibana
• And more...

Access templates from Compose → New Project → From Template.

Smart analysis and recommendations for your Compose configurations:

• YAML validation and syntax checking
• Security scanning for hardcoded secrets
• Best practices recommendations
• Auto-fix suggestions

The Free tier includes Compose support with the following limits:

• Maximum 2 Compose projects
• Maximum 5 total services across all projects

Upgrade to Pro for unlimited Compose projects and services.

Create isolated development environments from your Compose projects for rapid prototyping and testing.