**********************
devilbox documentation
**********************
.. :hidden:

.. image:: img/banner.png

The Devilbox is a modern dockerized LAMP and MEAN stack for local development on Linux, MacOS
and Windows.

It allows you to have an unlimited number of projects ready without having to install
any external software and without having to configure any virtual hosts. As well as providing a
very flexible development stack that you can run offline. (Internet is only required to initially
pull docker container).

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


.. important::
   :ref:`read_first`
     Ensure you have read this document to understand how this documentation works.


.. toctree::
   :maxdepth: 2
   :caption: About

   about/read-first
   about/features

.. toctree::
   :maxdepth: 2
   :numbered:
   :caption: Getting started

   getting-started/install-the-devilbox
   getting-started/update-the-devilbox
   getting-started/start-the-devilbox
   getting-started/directory-overview
   getting-started/create-your-first-project
   getting-started/read-log-files
   getting-started/email-catch-all
   getting-started/enter-the-php-container
   getting-started/the-intranet
   getting-started/best-practice


.. toctree::
   :caption: Maintenance
   :maxdepth: 2

   maintenance/backup-and-restore-mysql
   maintenance/backup-and-restore-pgsql
   maintenance/backup-and-restore-mongo


.. toctree::
   :maxdepth: 2
   :caption: Tutorials

   tutorials/communicating-with-external-hosts
   tutorials/add-your-own-docker-image
   tutorials/overwrite-existing-docker-image
   tutorials/adding-subdomains
   tutorials/change-container-versions
   tutorials/work-inside-the-container
   tutorials/enable-xdebug
   tutorials/custom-environment-variables
   tutorials/static-code-analysis


.. toctree::
   :maxdepth: 2
   :caption: Examples

   examples/setup-cakephp
   examples/setup-codeigniter
   examples/setup-drupal
   examples/setup-joomla
   examples/setup-laravel
   examples/setup-phalcon
   examples/setup-photon-cms
   examples/setup-symfony
   examples/setup-wordpress
   examples/setup-yii
   examples/setup-zend
   examples/setup-other-frameworks


.. toctree::
   :caption: Project configuration
   :maxdepth: 2

   configuration-project/dns-records
   configuration-project/custom-vhost


.. toctree::
   :caption: Global configuration
   :maxdepth: 2

   configuration-global/https-ssl
   configuration-global/auto-dns


.. toctree::
   :caption: Configuration files
   :maxdepth: 2

   configuration-files/env-file
   configuration-files/docker-compose-yml
   configuration-files/docker-compose-override-yml
   configuration-files/apache-conf
   configuration-files/nginx-conf
   configuration-files/php-ini
   configuration-files/php-fpm-conf
   configuration-files/my-cnf
   configuration-files/bashrc-sh


.. toctree::
   :caption: Readings
   :maxdepth: 2

   installation/docker-installation
   installation/docker-toolbox
   readings/available-container
   readings/available-tools
   readings/remove-stopped-container
   readings/syncronize-container-permissions


.. toctree::
   :caption: Advanced
   :maxdepth: 2


.. toctree::
   :caption: Support
   :maxdepth: 2

   support/faq
   support/troubleshooting
   support/blogs-videos-and-use-cases
   support/artwork