IsotoneStack - Portable Windows Development Environment
A complete, portable WAMP (Windows, Apache, MySQL/MariaDB, PHP) stack distributed as a pre-bundled package with the latest stable versions of all components.
๐ฆ Distribution Model
IsotoneStack follows the XAMPP distribution model:
- Pre-bundled components - All binaries included in the download
- No internet required - Works completely offline after download
- Portable installation - Can be moved between systems
- Zero configuration - Works out of the box
- Complete distribution - All components in
distribution/isotone-components/
Component Distribution
All required components are pre-bundled in C:\isotone\distribution\isotone-components\:
- Apache, PHP, MariaDB binaries
- Database management tools (phpMyAdmin, Adminer, phpLiteAdmin)
- Development tools (Mailpit, PowerShell)
- All dependencies and utilities
- Ready for offline installation
See distribution/isotone-components/COMPONENTS.md for complete component list.
๐ Components
Core Services
- Apache 2.4.65 (Latest stable web server)
- PHP 8.4.11 (Latest stable PHP runtime)
- MariaDB 12.0.2 (Latest stable database server)
- SQLite 3 (Built into PHP - file-based database)
Management Tools
- phpMyAdmin 5.2.2 (Latest stable - MariaDB management)
- phpLiteAdmin 1.9.8.2 (SQLite database management)
- Adminer 5.3.0 (Universal database management - supports MariaDB, SQLite, PostgreSQL, and more)
- Mailpit 1.27.7 (Email testing tool - captures and displays emails sent by your applications)
- Control Panel - Modern Python/CustomTkinter GUI
System Utilities
- NSSM 2.24 (Non-Sucking Service Manager - reliable Windows service management)
- PowerShell 7+ (Portable PowerShell for script execution)
- VC++ Runtime 2022 (Required runtime libraries)
โจ Features
- โ
Complete portable package (no separate downloads)
- โ
Modern GUI control panel
- โ
Windows service integration
- โ
No registry dependencies
- โ
Pre-configured for optimal performance
- โ
Virtual hosts manager
- โ
Database management interface
- โ
Email testing with Mailpit (captures all outgoing emails)
- โ
System tray integration
- โ
Dark/light theme support
๐ฅ Installation
Download Package
- Download the complete IsotoneStack package (includes all components)
- Extract to
C:\isotone
Manual Component Setup (for developers)
If you're building from source or updating components:
Download components manually:
Extract to correct directories:
C:\isotone\apache24\ โ Apache files
C:\isotone\php\ โ PHP files
C:\isotone\mariadb\ โ MariaDB files
C:\isotone\phpmyadmin\ โ phpMyAdmin files
C:\isotone\phpliteadmin\ โ phpLiteAdmin files
C:\isotone\adminer\ โ Adminer files
C:\isotone\mailpit\ โ Mailpit executable
Run setup script:
cd C:\isotone
.\Setup-IsotoneStack.ps1
๐ฎ Control Panel
GUI Control Panel (Recommended)
C:\isotone\control-panel\launch.bat
Features:
- Service management (start/stop/restart)
- Virtual hosts configuration
- Database management
- Port configuration
- Log viewer
- Settings management
PowerShell Scripts
Located in C:\isotone\:
# Configure and register services (run once)
.\Setup-IsotoneStack.ps1
# Start all services
.\Start-Services.ps1
# Stop all services
.\Stop-Services.ps1
# Check service status
.\Check-Status.ps1
# Uninstall services (preserves files)
.\Uninstall-Services.ps1
๐ Directory Structure
C:\isotone\
โโโ apache24/ # Apache 2.4.65+ binaries
โโโ php/ # PHP 8.4.11+ binaries
โโโ mariadb/ # MariaDB 12.0.2+ binaries
โโโ sqlite/ # SQLite databases directory
โโโ phpmyadmin/ # phpMyAdmin 5.2.2+ web app
โโโ phpliteadmin/ # phpLiteAdmin 1.9.8.2 SQLite manager
โโโ adminer/ # Adminer 5.3.0 universal DB manager
โโโ mailpit/ # Mailpit 1.27.7 email testing tool
โโโ bin/ # System utilities
โ โโโ nssm.exe # NSSM 2.24 service manager
โโโ runtime/ # VC++ Runtime installer (included)
โ โโโ vc_redist.x64.exe
โโโ distribution/ # Component distribution packages
โ โโโ isotone-components/ # All pre-bundled components
โ โโโ apache24/ # Apache distribution
โ โโโ php/ # PHP distribution
โ โโโ mariadb/ # MariaDB distribution
โ โโโ mailpit/ # Mailpit distribution
โ โโโ adminer/ # Adminer distribution
โ โโโ phpmyadmin/ # phpMyAdmin distribution
โ โโโ phpliteadmin/ # phpLiteAdmin distribution
โ โโโ pwsh/ # PowerShell distribution
โ โโโ bin/ # Binary utilities
โโโ control-panel/ # Python GUI application
โ โโโ main.py # Main application entry
โ โโโ ui/ # UI components
โ โโโ services/ # Service management
โโโ www/ # Your websites go here
โ โโโ default/ # Default website
โโโ logs/ # Centralized logs
โโโ config/ # Configuration templates
โโโ ssl/ # SSL certificates
โโโ tmp/ # Temporary files
โโโ backups/ # Database backups
๐ Access Points
โ๏ธ Configuration
Service Ports
- Apache: 80, 443 (SSL)
- MariaDB: 3306
- Mailpit SMTP: 1025
- Mailpit Web UI: 8025
- PHP: Via Apache module
Configuration Files
- Apache:
C:\isotone\apache24\conf\httpd.conf
- PHP:
C:\isotone\php\php.ini
- MariaDB:
C:\isotone\mariadb\data\my.ini
- phpMyAdmin:
C:\isotone\phpmyadmin\config.inc.php
๐ ๏ธ Troubleshooting
Services Won't Start
Check Administrator privileges:
# Run PowerShell as Administrator
Check port conflicts:
netstat -ano | findstr :80
netstat -ano | findstr :3306
Check Visual C++ Runtime:
- Included in
runtime\vc_redist.x64.exe
- Auto-installed by Setup script
- Manual install: Run
runtime\vc_redist.x64.exe
View Logs
# Apache errors
Get-Content C:\isotone\logs\apache\error.log -Tail 20
# PHP errors
Get-Content C:\isotone\logs\php\error.log -Tail 20
# MariaDB errors
Get-Content C:\isotone\logs\mariadb\error.log -Tail 20
๐ง Advanced Usage
Virtual Hosts
- Use the Control Panel's Virtual Hosts Manager, or
- Edit
C:\isotone\apache24\conf\extra\httpd-vhosts.conf:
<VirtualHost *:80>
ServerName myproject.local
DocumentRoot "C:/isotone/www/myproject"
<Directory "C:/isotone/www/myproject">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
- Add to
C:\Windows\System32\drivers\etc\hosts:
127.0.0.1 myproject.local
PHP Configuration
Create .user.ini in your project:
memory_limit = 1024M
max_execution_time = 600
upload_max_filesize = 256M
post_max_size = 256M
Email Testing with Mailpit
Mailpit captures all emails sent by your PHP applications for testing:
- Configure PHP to use Mailpit (already configured in php.ini):
SMTP = localhost
smtp_port = 1025
- Start Mailpit service (auto-starts with IsotoneStack):
.\Start-Services.ps1 # Includes Mailpit
View captured emails:
- Open http://localhost:8025
- All emails sent by your applications appear here
- No emails are actually sent externally
PHP mail() example:
mail('test@example.com', 'Test Subject', 'Test message body');
// This email will be captured by Mailpit
SSL Setup
- Generate certificates in
C:\isotone\ssl\
- Enable SSL in Apache configuration
- Restart Apache service
๐ System Requirements
- OS: Windows 10/11 (64-bit)
- RAM: 2GB minimum, 4GB+ recommended
- Disk: 2GB for installation
- Runtime: Visual C++ 2019-2022 Redistributable (included in
runtime folder)
๐ Security Notes
โ ๏ธ Default configuration is for development only!
For production:
- Change all default passwords
- Restrict service access
- Enable firewall rules
- Configure SSL/TLS
- Disable debug modes
- Review security settings
๐ License
IsotoneStack distribution is open source. Individual components are subject to their respective licenses:
- Apache: Apache License 2.0
- PHP: PHP License 3.01
- MariaDB: GPL v2
- phpMyAdmin: GPL v2
- Adminer: Apache License 2.0 or GPL v2
- Mailpit: MIT License
๐ Support
- Documentation: See
/docs directory
- Issues: Report on GitHub
- Logs: Check
C:\isotone\logs\
- Status: Run Control Panel or
.\Check-Status.ps1
IsotoneStack - Professional Development Environment for Windows
Version 1.0 | Built with the latest stable components