WebStack Deployer for Docker (WSDD)

Windows desktop application that automates the setup of a local web development environment using Docker. Includes multi-version PHP, local SSL, MySQL, phpMyAdmin, and hosts management.

Languages: English | Español | Français | हिन्दी | 中文

System Requirements

• Operating System: Windows 10 / Windows 11
• Privileges: Administrator (required)
• Docker Desktop: Automatically installed if not present
• WSL 2: Automatically configured
• Chocolatey: Automatically installed if not present

What This Application Does

1. Verifies and installs dependencies: Docker Desktop, WSL 2, Chocolatey, MKCert
2. Configures the Docker stack: Nginx reverse proxy, MySQL, phpMyAdmin
3. Manages web projects: Creates PHP containers per version with Apache + Xdebug
4. Automatic local SSL: MKCert certificates per domain, no browser warnings
5. Automatic hosts: Modifies C:\Windows\System32\drivers\etc\hosts for you

Docker Stack Containers

Base Services (always active)

• WSDD-Proxy-Server — Nginx reverse proxy (ports 80 / 443)
• WSDD-MySql-Server — MySQL 8 (port 3306)
• WSDD-phpMyAdmin-Server — phpMyAdmin

PHP Containers (one per version used)

Available versions: 5.6 - 7.2 - 7.4 - 8.1 - 8.2 - 8.3 - 8.4

For each activated version, the following development URLs are created:

• php{version}.wsdd.dock — Main PHP environment
• cron{version}.wsdd.dock — Cron jobs manager
• wm{version}.wsdd.dock — Webmin (server administration)

Disk Environment Structure

The application creates and manages the C:\WSDD-Environment\ directory:

C:\WSDD-Environment\
├── PS-Script\          — PowerShell automation scripts
├── Docker-Structure\   — docker-compose and PHP images
├── certs\              — SSL certificates per domain
└── wsdd-config.json    — Application configuration

First Launch — Automatic Process

1. The application verifies it has administrator privileges
2. Extracts embedded resources to C:\WSDD-Environment\
3. Checks Chocolatey → installs if missing
4. Checks Docker Desktop → installs if missing (requires restart)
5. Checks MKCert → installs and configures local CA
6. Starts the base Docker stack
7. Shows the main panel

Note: Docker Desktop installation may require a system restart. The application will automatically resume after restart.

Usage After First Launch

Adding a Project

1. Click "Add Project"
2. Choose the local domain (e.g., myproject.wsdd.dock)
3. Select the PHP version
4. The application creates the container, SSL certificate, and hosts entry

Managing Containers

• Start / stop individual containers from the main panel
• Open real-time logs with one click
• Restart the complete stack from the menu

Technical Information

• Version: 1.0.0-rc.3 (Rust edition)
• GUI: egui / eframe (immediate-mode)
• Async: tokio
• Configuration: JSON at C:\WSDD-Environment\wsdd-config.json
• Logs: Environment variable RUST_LOG=wsdd=debug for detailed logs

License

Proprietary — see LICENSE.md for details. Copyright (c) 2026 Walter Nunez / Icaros Net S.A. All Rights Reserved.