The devilbox

Usage | Documentation | Run-time Matrix | Features | Intranet | Screenshots | License | Contributing | Todo

The devilbox is a modern and highly customizable alternative for XAMPP. It is based on docker-compose with presets for all kinds of versions for webservers, database servers and php.

Configuration is not necessary, as everything is pre-setup with mass virtual hosting.

Supported operating systems

_{It might run on FreeBSD, but I don't know the status of docker-compose there.}

---

Quick start

You are up and running in three simple steps:

# Copy the example configuration file
$ cp env-example .env

# Edit your configuration
$ vim .env

# Start all containers
$ docker-compose up

Selective start

$ docker-compose up httpd php mysql redis

$ docker-compose up httpd php mysql pgsql redis memcd

$ docker-compose up httpd php pgsql memcd

Feature overview

The devilbox has everything setup for you. The only thing you will have to install is docker and docker-compose. Virtual hosts and DNS entries will be created automatically, just by adding new project folders.

• Mass virtual host
• Custom domains (*.loc, *.local, *.dev, ...)
• Auto-DNS (Internal Bind server running)
• Email catch-all (Internal postfix with catch-all)
• Log files (available on host computer)
• Config overwrites (my.cnf, nginx.conf, httpd.conf or php.ini)
• Tools (git, composer, node, npm, drush, drupal-console, ...)
• Xdebug

Batteries included:

• phpMyAdmin
• Adminer
• OpcacheGUI
• Mail viewer

Documentation

Video Tutorials

Documentation

For setup, usage and examples see detailed Documentation.

Run-time Matrix

Select your prefered version. (By editing the .env file)

No need to install and configure different versions locally. Simply choose your required LAMP/LEMP stack versions during startup and it is up and running instantly.

1/3 Base stack (required)

DNS	Webserver	PHP
Bind	Apache 2.2	PHP 5.4
	Apache 2.4	PHP 5.5
	Nginx stable	PHP 5.6
	Nginx mainline	PHP 7.0
		PHP 7.1
		HHVM latest

_{Note: Entries without links or without build-status are planned, but not yet available. See ROADMAP for tasks and upcoming features.}

2/3 SQL stack (optional)

MySQL	PostgreSQL	MS SQL
MySQL 5.5	PgSQL 9.1	MS SQL 2017
MySQL 5.6	PgSQL 9.2
MySQL 5.7	PgSQL 9.3
MySQL 8.0	PgSQL 9.4
MariaDB 5.5	PgSQL 9.5
MariaDB 10.0	PgSQL 9.6
MariaDB 10.1
MariaDB 10.2
MariaDB 10.3

_{Note: Entries without links or without build-status are planned, but not yet available. See ROADMAP for tasks and upcoming features.}

3/3 NoSQL stack (optional)

Cassandra	CouchDB	Memcached	MongoDB	Redis
Cassandra 2.1	CouchDB 1.6	Memcached latest	MongoDB 2.6	Redis 2.8
Cassandra 2.2	CouchDB 2.0		MongoDB 3.0	Redis 3.0
Cassandra 3.0			MongoDB 3.2	Redis 3.2
			MongoDB 3.4

_{Note: Entries without links or without build-status are planned, but not yet available. See ROADMAP for tasks and upcoming features.}

Intranet overview

The devilbox comes with a pre-configured intranet on http://localhost

• Virtual Host overview
• MySQL Database overview
• PostgreSQL Database overview
• Email overview
• PHP Info
• MySQL Info
• PostgreSQL Info
• phpMyAdmin
• Adminer
• Opcache GUI

Screenshots

Homepage with host / docker information

The homepage shows you the status of your current configured setup.

• which versions are used
• what directories are mounted
• what other settings have been set

Virtual Host overview

This overview shows you all available virtual hosts and if they need additional configuration (on the host)

Virtual Hosts are considered valid if the following requirements are met (on the host system):

• htdocs folder/symlink exists in your project folder
• /etc/hosts has a valid DNS config for your host: 127.0.0.1 <project-folder>.loc)

Database overview

Shows you all the databases that are loaded

Email overview

Shows you all the emails that have been sent. No email will actually be sent outside, but they are all catched by one account and presented here.

Contributing

There is quite a lot todo and planned. If you like to contribute, view CONTRIBUTING.md and ROADMAP.

Contributors will be credited within the intranet and on the github page.