devilbox/README.md
2016-10-29 11:18:38 +02:00

7.5 KiB

Devilbox The devilbox

Note for OSX:

There is currently a huge annoyance with docker on OSX resulting in very slow file access, because of directory mounts. Read about the ticket here Docker Forums #8076.


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

Build Status Technology License

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

Linux Windows OSX

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


Usage

You are up and running in three simple steps:

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

# Edit your configuration
$ vim .env

# Start the dockers
$ docker-compose up

Overview Video

Devilbox setup and workflow

Run-time Matrix

Select your prefered setup.

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

Webserver Database PHP
Build Status Apache 2.2 Build Status MySQL 5.5 Build Status PHP 5.4
Build Status Apache 2.4 Build Status MySQL 5.6 Build Status PHP 5.5
Build Status Nginx stable Build Status MySQL 5.7 Build Status PHP 5.6
Build Status Nginx mainline Build Status MariaDB 5.5 Build Status PHP 7.0
Build Status MariaDB 10.0 Build Status PHP 7.1
Build Status MariaDB 10.1
MariaDB 10.2

Feature overview

  • Dynamically Configured Mass Virtual Hosting
  • Configuration overwrites (my.cnf, nginx.conf, httpd.conf or php.ini)
  • Log files available on host computer
  • MySQL socket (available on host computer and PHP container)
  • MySQL connectivity (reachable from host computer and from PHP container via 127.0.0.1 and localhost)
  • Xdebug

Intranet overview

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

  • Virtua lHost overview
  • Database overview
  • PHP Info
  • MySQL Info
  • PHPMyAdmin
  • Opcache GUI

Contributing

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

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

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

Intranet Home

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)

Intranet vHost

Database overview

Shows you all the databases that are loaded

Intranet DB