In order to run the Devilbox you need to have Docker and Docker Compose installed on your system. Read through the Devilbox Prerequisites documentation for more information on that, if you are not running these applications yet on your system.
There is no installation routine. You just have to download the files from the Devilbox GitHub Page into an empty directory. The configuration takes place via a single file. In your directory you will find the file
env-example. Copy and rename
the file to
.env. In the new file you can now make your configurations. The following settings need to be changed:
The individual steps (especially for the entries
NEW_GID) are well described in the Devilbox Documentation. For Contao itself, the other entries should be set to something like this:
After every change in the configuration
.env file, the Devilbox must be restarted.
Do not delete entries in the .env file! For example, by default, the entry
is set and
# HTTPD_SERVER=apache-2.4 is disabled (see
# at the beginning of the line). To change such
entries you only have to enable or disable them by adding or removing the comment symbol. Make sure to enable
HTTPD_SERVER=apache-2.4. As a web server nginx
could also be used. For Contao, however, further configuration of the web server will then be necessary.
Change to the directory and start the Devilbox with Docker. Initially it can take a while to create and load each Docker image and the containers. Restarts are much faster afterwards.
docker-compose up -d httpd php mysql
Once the Devilbox has started you can access the Devilbox dashboard in your browser under
http: //127.0.0.1. The navigation gives you access to the various functions.
The IP address to use depends on your Docker environment. If you have the Docker-Toolbox installed, your IP address
may be different. The IP address can be determined by using the command
|Virtual Hosts||List of existing vhosts or websites|
|Emails||E-Mail catch service|
|Tools||Access to tools such as
One or more Contao installations are created in the Devilbox directory
data\www. Each Contao installation will
reside in its own directory there. The directory name you choose will correspond to the vhost name. For example, a
contao4 will correspond to a vhost for
You have created a directory (e. g.
contao4). Change to this directory and create a new subfolder
web. Copy the
.phar file into this folder and rename the file to
The domain suffix
.loc is the default. However, this can be changed in the
.env file via the entry
The manual editing of »
/etc/hosts« may be neglected. The »Devilbox« offers a
“Auto DNS feature.
phpMyAdmin in the Devilbox dashboard via
Tools\phpMyAdmin and create a new database. Change then
in the navigation to the page
Virtual Hosts. Here you should see a list of your existing web projects
and you can call them right away. You can now initiate the Contao installation via the Contao Manager. For example:
The further procedure is then identical to the normal installation.
By default, the PHP memory limit for the Devilbox’s PHP container is too low and therefore must be previously configured for Composer.
Change to the directory
cfg. Did you configure the devilbox with PHP 7.3 in the
.env file, make the following changes
accordingly in the directory
cfg\php-ini-7-3. Create a file
memory_limit.ini with the following entry:
[PHP] memory_limit = -1
Afterwards you have to restart the Devilbox. The Devilbox main directory contains the files
So you can plug into the running Devilbox PHP container. Here are already numerous tools preinstalled. Also
composer. After calling you are in the directory
shared\http. To install e. g. Contao 4.8 in a directory
contao48 you just have to enter:
composer create-project contao/managed-edition contao48 4.8
Create a new database:
mysql -u root -h mysql -p -e 'CREATE DATABASE db_contao49;'
Afterwards you can leave the container via
exit and open the Contao Install Tool.
The settings for the Contao Install Tool are basically identical. You only have to pay attention to the following entries:
|Password||Do not enter a value|
root with empty password is the Devilbox default setting. This could be changed in the Devilbox configuration. In this case, you must enter your configured credentials in the Contao Install Tool.