mnunes/deva2 repository overview

This is a Docker⁠ image providing a development environment (LEMP) with Nginx, PHP 7, MySQL (MariaDB), Redis and SSMTP (for testing emails in PHP). It uses the lightweight Alpine Linux. PHP is installed along with the Phalcon framework, XDebug and other extensions that you would find available in most production servers.

It also includes a web based control panel where you can:

• Manage virtual hosts
• See service current and latest versions
• Upgrade the Phalcon framework
• Restart services
• Configure SMTP
• Backup and restore

Note: DevA2's intended use is for development in a safe environment only. It is NOT suitable for hosting websites in production!

⁠Usage

1. Create the directory where the websites will be located
2. Run the following command (change "$HOME"/Sites to that directory)

docker run -dit --restart unless-stopped \
    --name deva2 \
    -p 80:80 -p 443:443 -p 3306:3306 \
    -v "$HOME"/Sites:/var/www \
    mnunes/deva2:latest

Open http://localhost⁠ in your browser.

⁠Versions

⁠Architectures

• amd64
• arm64 (since 1.4.0)

⁠Ports

• HTTP: 80
• HTTPS: 443
• MySQL: 3306
• Redis: 6379

⁠Database Credentials

• Host: 127.0.0.1
• Username: root
• Password:

⁠Changelog

See CHANGELOG.md⁠.

⁠Upgrading

DevA 2 doesn't provide an easy upgrade method. If you need to upgrade to a newer version of DevA 2, you can either upgrade the packages manually (by accessing the image directly), or remove the current image and create a new one with the latest version. For the latter, here's how:

1. Backup your website virtual hosts and databases (no websites)
2. Stop⁠ the current DevA 2 image
3. Remove⁠ the old DevA 2 image
4. Leave the directory where the websites are as it is
5. Install DevA 2 again the normal way⁠
6. Restore the backup

⁠Build

git clone [email protected]:mignz/DevA2.git
cd DevA2 && docker build -t deva2 .

⁠Bonus

⁠Route .test domains

Install dnsmasq to route all .test domains to 127.0.0.1 without having to alter the hosts file every time you add a new virtual host. There are some guides on how to do exactly that on macOS and Linux.

http://www.thekelleys.org.uk/dnsmasq/doc.html⁠

⁠Access Xdebug

I followed this⁠ guide for the Xdebug configuration. You'll need to run the following command to give Xdebug access to the host machine:

sudo ifconfig lo0 alias 10.254.254.254

Note: Xdebug remote is disabled by default. To enable it, run the following command in the container: sed -i 's/xdebug.remote_autostart = 0/xdebug.remote_autostart = 1/' /etc/php7/php.ini and restart PHP-FPM.

⁠Trust self-signed certificates

Download all the certificates you need from cp.test.

• Instructions for macOS⁠
• Instructions on Linux⁠