The GodBox!

The Godbox is a devilbox inspired project fosed on advanced Laravel developer. The Godbox is a modern and highly customisable dockerized PHP stack supporting full LAMP and MEAN and running on all major platforms. The main goal is to easily switch and combine any version required for local development. It supports an unlimited number of projects for which vhosts, SSL certificates and DNS records are created automatically. Reverse proxies per project are supported to ensure listening server such as NodeJS can also be reached. Email catch-all and popular development tools will be at your service as well. Configuration is not necessary, as everything is already pre-setup.

Furthermore, the Godbox provides an identical and reproducible development environment for different host operating systems.

Requirements

• Docker Engine 17.06.0+
• Docker Compose 1.16.0+

#Architecture

#Available Stacks

The Godbox aims to be a swiss army knife for local development by providing you all the services you would ever need. To get an idea about the architecture behind it and to also see what's available have a look at the following diagrams and tables.

#Available Container

The following table lists all integrated and pre-configured Docker container shipped by the Godbox. Only the webserver and PHP container are mandatory, all others are optional and don't need to be started.

Each of them is also available in multiple different versions in order to reflect your exact desired environment.

#Usage

#Quick start

# Get the Godbox
git clone https://github.com/icarojobs/godbox devilbox

# Create docker-compose environment file
cd devilbox
mkdir jenkins
mkdir dumps
cp env-example .env

# Edit your configuration
vim .env

# Start all container
docker-compose up

# Start all container
C:\devilbox> docker-compose up

#Selective start

The above will start all containers, you can however also just start the containers you actually need. This is achieved by simply specifying them in the docker-compose command.

docker-compose up httpd php mysql redis

#Run different versions

Every single attachable container comes with many different versions. In order to select the desired version for a container, simply edit the .env file and uncomment the version of choice. Any combination is possible.

^[1] PHP 5.2 is available to use, but it is not officially supported. The Godbox intranet does not work with this version as PHP 5.2 does not support namespaces. Furthermore PHP 5.2 does only work with Apache 2.4, Nginx stable and Nginx mainline. It does not work with Apache 2.2. Use at your own risk.

^[2] PHP 8.0 / PHP 8.1 are upcoming unreleased versions of PHP, which are directly built out of their official git branches every night to assure you will leverage their latest features.

#Additional services

Additionally to the default stack, there are a variety of other services that can be easily enabled and started.

#Enter the container

You can also work directly inside the php container. Simply use the bundled scripts shell.sh (or shell.bat for Windows). The PS1 will automatically be populated with current chosen php version. Navigate the the Godbox directory and type the below listed command:

host> ./shell.sh
godbox@php-7.0.19 in /shared/httpd $

C:\godbox> shell.bat
godbox@php-7.0.19 in /shared/httpd $

Your projects can be found in /shared/httpd. DNS records are automatically available inside the php container. Also every other service will be available on 127.0.0.1 inside the php container (tricky socat port-forwarding).

#License

MIT License

Copyright (c) 2016 icarojobs