Skip to content

Drmzindec/Devilbox-Boost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,816 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Devilbox Boost

Modern PHP 8.3/8.4 development stack powered by Docker

License: MIT PHP Docker Laravel WordPress

Features โ€ข Quick Start โ€ข Documentation โ€ข Contributing


Devilbox Boost modernizes the official Devilbox with PHP 8.3/8.4 support, modern development tools (Bun, Vite, Pest), and quality-of-life improvements.


โšก Quick Start

New installation:

git clone https://github.com/cytopia/devilbox.git && cd devilbox
curl -sSL https://raw.githubusercontent.com/Drmzindec/Devilbox-Boost/main/install.sh | bash
./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

First project:

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

๐Ÿ“– Detailed guide: QUICKSTART.md


โœจ Features

๐Ÿ˜ Modern PHP Stack

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

๐Ÿ› ๏ธ Modern JavaScript Tools

  • 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

๐Ÿ—„๏ธ Database & Caching

  • MySQL 8.0 / MariaDB
  • PostgreSQL 16
  • MongoDB 7
  • Redis 7
  • Memcached

๐ŸŽฏ Smart Automation

  • 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

๐ŸŽจ Updated Admin Tools

  • 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

๐Ÿค– AI Integration (Optional)

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

โšก Modern Services (Optional)

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

๐Ÿ“Š Devilbox vs Devilbox Boost

Feature Devilbox Devilbox Boost
PHP 8.4 Support โŒ โœ…
Modern Tools โš ๏ธ Outdated (2023) โœ… Bun, Vite, Pest
Setup Time โฑ๏ธ 1-2 hours manual โฑ๏ธ 10 minutes wizard
Laravel Auto-Config โŒ Manual vhost โœ… Auto-detected
WordPress Support โš ๏ธ Manual setup โœ… WP-CLI + auto-config
Admin Tools โš ๏ธ PHP warnings โœ… PHP 8.4 compatible
AI Integration โŒ โœ… Claude Code MCP
Documentation โš ๏ธ Outdated โœ… Comprehensive guides

๐Ÿ’ป Usage Examples

Create Laravel Project

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

Create WordPress Site

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

Use Modern Tools

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

Database Operations

# 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

๐Ÿ“š Documentation

Document Description
QUICKSTART.md 10-minute setup guide
SETUP-WIZARD.md Interactive wizard walkthrough
MIGRATION.md Upgrade from vanilla Devilbox
CONTRIBUTING.md Contribution guidelines
CHANGELOG.md Version history
Roadmap Future features and milestones

Service Guides


๐Ÿ”ง Requirements

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

๐Ÿ“ฅ Installation Options

Option 1: New Installation (Recommended)

# 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

Option 2: Upgrade Existing Devilbox

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

Option 3: Manual Installation

See MIGRATION.md for detailed manual setup.


๐ŸŽฎ Access Points

Service URL
Dashboard http://localhost
phpMyAdmin http://localhost/vendor/phpmyadmin-5.2.3/
Adminer http://localhost/vendor/adminer-5.4.2-devilbox.php
phpCacheAdmin http://localhost/vendor/phpcacheadmin-2.4.1/
OpCache GUI http://localhost/vendor/opcache-gui-3.6.0.php

Database Credentials:

Host: 127.0.0.1
Username: root
Password: root

๐Ÿš€ What's New in v1.0.0

  • โœ… PHP 8.3 & 8.4 with custom Docker images
  • โœ… Modern tools - Bun, Vite, Pest, latest Node.js
  • โœ… Auto vhost detection - Laravel, WordPress, Symfony
  • โœ… Updated admin tools - All PHP 8.4 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

See CHANGELOG.md for complete details.


๐Ÿค Contributing

Contributions welcome! See CONTRIBUTING.md for:

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

๐Ÿ› Troubleshooting

Port 80 in use?

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

Database connection failed?

Always use 127.0.0.1 not localhost:

DB_HOST=127.0.0.1  # โœ… Correct
DB_HOST=localhost  # โŒ Won't work

Project shows 404?

Wait 30 seconds for vhost auto-detection:

sleep 30
docker compose restart httpd

More help: QUICKSTART.md#troubleshooting


๐Ÿ“œ License

MIT License - see LICENSE for details.

Based on Devilbox by cytopia.


๐ŸŒŸ Show Your Support

If Devilbox Boost helps your development workflow:

  • โญ Star this repository
  • ๐Ÿ› Report bugs and suggest features
  • ๐Ÿค Contribute improvements
  • ๐Ÿ“ฃ Share with other developers

๐Ÿ”— Links


Built with โค๏ธ for the PHP community

Get Started โ€ข View Docs โ€ข Contribute