New installation:

curl -sSL https://raw.githubusercontent.com/Drmzindec/Devilbox-Boost/main/install.sh | bash
cd Devilbox-Boost
./setup-devilbox.sh  # Interactive wizard

Upgrade existing Devilbox:

cd /path/to/devilbox
curl -sSL https://raw.githubusercontent.com/Drmzindec/Devilbox-Boost/main/install.sh | bash

Auto-DNS setup (one-time):

Devilbox includes a DNS server so every project in data/www/ auto-resolves — no /etc/hosts editing needed.

sudo bash -c 'mkdir -p /etc/resolver && echo -e "nameserver 127.0.0.1\nport 1053" > /etc/resolver/loc'

# Add to /etc/systemd/resolved.conf under [Resolve]:
DNS=127.0.0.1:1053
Domains=~loc

sudo systemctl restart systemd-resolved

First project:

docker compose exec php laravel new my-blog
# Visit http://my-blog.loc (auto-configured!)

📖 Detailed guide: QUICKSTART.md

• PHP 8.3, 8.4 & 8.5 - Zero deprecation warnings
• Laravel Installer - Instant Laravel projects
• WP-CLI - WordPress management
• Pest - Modern testing framework
• Composer 2.9.5 - Latest dependency manager

• Bun 1.3.9 - Fast all-in-one toolkit
• Vite 7.3.1 - Lightning-fast builds
• Node.js 24 - Latest LTS
• Vue/React/Angular CLIs - Framework scaffolding
• Prettier & ESLint - Code quality

• MariaDB 10.6 (MySQL 8.0 also available)
• PostgreSQL 18
• MongoDB 8.0
• Redis 8.6
• Memcached

• Auto Vhost Detection - Laravel, WordPress, Symfony auto-configured
• Port Forwarding - Use 127.0.0.1 for database connections
• Setup Wizard - 10-minute interactive configuration
• Command Wrappers - Run composer, artisan, npm directly on host

• phpMyAdmin 5.2.3 - Pre-filled login (127.0.0.1, root:root)
• Adminer 5.4.2 - Lightweight database manager
• phpCacheAdmin 2.4.1 - Redis/Memcached unified UI
• OpCache GUI 3.6.0 - Performance monitoring
• phpPgAdmin 7.13.0 - PostgreSQL admin

• MCP Server - Claude Code integration
• 10+ tools - Service management, database ops, health checks
• Automated workflows - AI-assisted development

• Meilisearch - Lightning-fast search engine
• Mailpit - Modern email testing (replaces Mailhog)
• RabbitMQ - Message queue for async tasks
• MinIO - S3-compatible object storage

docker compose exec php laravel new my-app
# Auto-detected, configured, ready at http://my-app.loc

docker compose exec php wp core download --path=my-site
# Visit http://my-site.loc to complete setup

docker compose exec php bun install    # Fast package install
docker compose exec php vite build     # Lightning builds
docker compose exec php pest           # Modern testing

# MySQL
docker compose exec php mysql -h 127.0.0.1 -u root -proot --skip-ssl

# Redis
docker compose exec php redis-cli -h 127.0.0.1

# PostgreSQL
docker compose exec php psql -h 127.0.0.1 -U postgres

• Modern Services - Meilisearch, Mailpit, RabbitMQ, MinIO
• Using Redis - Cache, sessions, queues
• Using Memcached - High-performance caching
• Using MySQL - Advanced SQL features
• Using PostgreSQL - JSONB, full-text search
• Using MongoDB - Document store operations

• OS: macOS, Linux, or Windows (WSL2)
• Docker: Desktop 20.10+
• RAM: 8GB minimum (16GB recommended)
• Disk: 20GB free space

# 1. Clone Devilbox
git clone https://github.com/cytopia/devilbox.git
cd devilbox

# 2. Install Boost
curl -sSL https://raw.githubusercontent.com/Drmzindec/Devilbox-Boost/main/install.sh | bash

# 3. Run wizard
./setup-devilbox.sh

cd /path/to/devilbox
curl -sSL https://raw.githubusercontent.com/Drmzindec/Devilbox-Boost/main/install.sh | bash
./docker-images/build-php.sh 8.4
docker compose up -d

See MIGRATION.md for detailed manual setup.

Database Credentials:

Host: 127.0.0.1
Username: root
Password: root

• ✅ PHP 8.3, 8.4 & 8.5 with custom Docker images
• ✅ Modern tools - Bun, Vite, Pest, latest Node.js
• ✅ Auto vhost detection - Laravel, WordPress, Symfony
• ✅ Updated admin tools - All PHP 8.5 compatible
• ✅ Interactive wizard - 10-minute setup
• ✅ MCP server - Claude Code AI integration
• ✅ Comprehensive docs - Guides for all services
• ✅ Port forwarding - Direct 127.0.0.1 connections
• ✅ Command wrappers - Run tools from host
• ✅ Quick Start snippets - Connection examples for all services
• ✅ Lean mode - Minimal 4-container alternative via docker-compose.lean.yml
• ✅ Modern services built-in - Meilisearch, Mailpit, RabbitMQ, MinIO in default stack

See CHANGELOG.md for complete details.

Contributions welcome! See CONTRIBUTING.md for:

• Bug reports
• Feature requests
• Pull request process
• Development setup

# Use different port
echo "HOST_PORT_HTTPD=8000" >> .env
docker compose restart
# Access via http://localhost:8000

Always use 127.0.0.1 not localhost:

DB_HOST=127.0.0.1  # ✅ Correct
DB_HOST=localhost  # ❌ Won't work

Wait 30 seconds for vhost auto-detection:

sleep 30
docker compose restart httpd

More help: QUICKSTART.md#troubleshooting

MIT License - see LICENSE for details.

Based on Devilbox by cytopia.

If Devilbox Boost helps your development workflow:

• ⭐ Star this repository
• 🐛 Report bugs and suggest features
• 🤝 Contribute improvements
• 📣 Share with other developers

• Issues: Report bugs
• Discussions: Q&A and ideas
• Original Devilbox: cytopia/devilbox