devilbox/docs

Devilbox Documentation

Overview | Installing | Updating | Configuration | Run | Usage | Examples | Technical | Hacking | FAQ

---

Overview

1. Main idea
2. Supported Host OS
3. Requirements
4. Docker documentation
5. Devilbox documentation
6. Video Tutorials
7. Supported Frameworks and CMS

---

1. Main idea

The devilbox allows you to have an unlimitted number of projects ready without having to install any external software and without having to configure any virtual hosts.

The only thing you will have to do is to create a new folder on the filesystem and your virtual host is ready to be served with your custom domain.

The default project catch-all domain is *.dev (can be changed). Let's see an example:

# Inside your main project folder
$ ls -l
drwxr-xr-x 3 cytopia 4096 Jun 10 13:10 my-drupal
drwxr-xr-x 3 cytopia 4096 Jun 10 13:10 my-wordpress
drwxr-xr-x 3 cytopia 4096 Jun 10 13:10 project1
drwxr-xr-x 3 cytopia 4096 Jun 10 13:10 project2
drwxr-xr-x 3 cytopia 4096 Jun 10 13:10 yii-test

By having the above folders, the devilbox will automatically be able to serve the following vhosts:

• http://my-drupal.dev
• http://my-wordpress.dev
• http://project1.dev
• http://project2.dev
• http://yii-test.dev

New folders can be created, deleted and removed during run-time and corresponding virtual hosts will be available instantly without having to restart anything.

2. Supported Host OS

The devilbox runs on all major operating systems. Below you can quickly check the recommended docker versions and current issues per OS.

Docker Version	normal	Docker for Windows	Docker dor Mac
Current Issues	here	here	here

3. Requirements

• Internet connection - only required during initial setup for cloning the devilbox repository and pulling the required docker container. Afterwards you can always work offline.
• Docker Engine 1.12.0+
• Docker Compose 1.6.0+
• On Windows use Docker for Windows (not tested on Docker Toolbox)
• On OSX use Docker for Mac (not tested on Docker Toolbox)

4. Docker documentation

If you have never worked with docker/docker-compose before, you should check up on their documentation to get you started: docker docs.

5. Devilbox documentation

Topic	Description
Installing	How to install docker, docker-compose and the devilbox
Updating	Update best practise
Configuration	How to configure the devilbox, switch versions (PHP, MySQL, PgSQL, ...) and how to set custom options (php.ini, my.cnf, httpd.conf, ...)
Run	How to operate the devilbox, start and stop all or only required Docker container.
Usage	How to create projects, Email and DNS usage, tools (composer, npm, node, drush, ...), entering the container, Log files, Xdebug, Backups, Intranet, ...
Examples	Some project examples for popular CMS/Frameworks. How to setup Wordpress, Drupal, Yii, ...
Technical	Technical background information
Hacking	How to extend the devilbox with your own docker container
FAQ	Questions and Troubleshooting

6. Video Tutorials

Have a look at youtube to see some the features in action.

7. Supported Frameworks and CMS

As far as tested there are no limitations and you can use any Framework or CMS just as you would on your live environment. Below are a few examples of extensively tested Frameworks and CMS: