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:
- Apache 2.4.65+ from apachelounge.com
- PHP 8.4.11+ from windows.php.net
- MariaDB 12.0.2+ from mariadb.org
- phpMyAdmin 5.2.2+ from phpmyadmin.net
- phpLiteAdmin 1.9.8.2+ from phpliteadmin.org
- Adminer 5.3.0+ from adminer.org
- Mailpit 1.27.7+ from github.com/axllent/mailpit

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

Web Server: http://localhost
phpMyAdmin: http://localhost/phpmyadmin (MariaDB management)
phpLiteAdmin: http://localhost/phpliteadmin (SQLite management)
Adminer: http://localhost/adminer (Universal database management)
SQLite Direct: http://localhost/sqlite (Alias to phpLiteAdmin)
Mailpit Web UI: http://localhost:8025 (Email testing interface)
MariaDB: localhost:3306
Mailpit SMTP: localhost:1025 (SMTP server for capturing emails)
SQLite: File-based in C:\isotone\sqlite\
- Default user: root
- Default password: (set during setup)

⚙️ 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

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.windsurf/rules		.windsurf/rules
adminer		adminer
config		config
default		default
iso-control		iso-control
phpliteadmin		phpliteadmin
scripts		scripts
sqlite		sqlite
.gitattributes		.gitattributes
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
INSTALL.bat		INSTALL.bat
LICENSE		LICENSE
README.md		README.md

License

rizonesoft/IsotoneStack

Folders and files

Latest commit

History

Repository files navigation