Docker LEMP

Docker Containers for Web Development on LEMP stack

LEMP is an environment built with Docker and oriented to Web development on LEMP stack.

The term LEMP is an acronym that represents the environment configuration, based on:

Linux as Operating System
Engine-X as Web Server
MySQL database to store data
PHP to process dynamic content

The environment uses the following Docker Containers availables on Docker Hub:

NGINX (Docker Hub: nginx:alpine)
MariaDB (Docker Hub: mariadb:latest)
PHP (Docker Hub: php:fpm-alpine)

Software and Tools

The solution includes also extra software and tools:

Aliases for docker-compose commands

You can use shortcuts for docker-compose commands and container commands.

Execute this command from shell to add the aliases:
. .aliases

Now following shortcuts will be available.

Shortcuts for docker-compose commands or to execute commands inside the containers:

shortcut	command	description
dc	docker-compose
dc-linux	docker-compose exec php bash	Linux Shell
dc-php	docker-compose exec php php	PHP
dc-composer	docker-compose exec php composer	Composer
dc-symfony	docker-compose exec php symfony	Symfony
dc-mysql	docker-compose exec mysql mysql	MySQL

Examples:

shortcut	command	description
dc build	docker-compose build
dc up -d	docker-compose up -d
dc down	docker-compose down
dc start	docker-compose start
dc stop	docker-compose stop
dc restart	docker-compose restart
dc logs -f	docker-compose logs -f
dc images	docker-compose images
dc ps	docker-compose ps

Setup

Requirements

Docker installed on the operating system:

Install, Configuration and Build

Clone LEMP from the repository into your app folder:
git clone https://github.com/ricfio/docker-lemp.git app

Move in the app (docker-lemp) folder:
cd app

You can customize the configuration changing several variables in the .env file.
Following some example:

Key	Description	Current value
APP_NAME	Application name	app
APP_PATH_WWW	Application www path	./www
NGINX_VERSION	NGINX version	1.19
NGINX_HOST	NGINX server_name	localhost
NGINX_ROOT	NGINX root	/var/www
NGINX_PORT_HTTP	NGINX http port	80
NGINX_PORT_HTTPS	NGINX https port	443
MYSQL_USER	MySQL user	user
MYSQL_PASSWORD	MySQL password	user
MYSQL_ROOT_PASSWORD	MySQL root password	root
MYSQL_PORT	MySQL port	3306
PHP_VERSION	PHP version	7.4.16
PHP_SYSTEM_TZ	PHP timezone	Europe/Rome

Build the Docker Containers:
docker-compose build

docker image ls lemp_*

REPOSITORY   TAG       IMAGE ID       CREATED         SIZE
lemp_nginx   latest    6effdfc67af3   3 days ago      22.6MB
lemp_mysql   latest    19279c96333c   3 days ago      401MB
lemp_php     latest    93ac44225405   21 hours ago    122MB

Start all services (in background mode):
docker-compose up -d

Creating network "app" with the default driver
Creating app_nginx ... done
Creating app_mysql ... done
Creating app_php   ... done

List all services running:
docker container ls --all -f NAME=app_*

CONTAINER ID   IMAGE        COMMAND                  CREATED          STATUS          PORTS                                         NAMES
775dd4387a8e   lemp_nginx   "/docker-entrypoint.…"   30 seconds ago   Up 30 seconds   0.0.0.0:8080->80/tcp, 0.0.0.0:8443->443/tcp   app_nginx
24d77f6138b3   lemp_mysql   "docker-entrypoint.s…"   30 seconds ago   Up 30 seconds   0.0.0.0:3306->3306/tcp                        app_mysql
6763b26b9e20   lemp_php     "docker-php-entrypoi…"   30 seconds ago   Up 30 seconds   9000/tcp                                      app_php

docker-compose ps

app_nginx   /docker-entrypoint.sh nginx     Up      0.0.0.0:8443->443/tcp, 0.0.0.0:80->80/tcp
app_mysql   docker-entrypoint.sh mysqld     Up      0.0.0.0:3306->3306/tcp
app_php     docker-php-entrypoint php-fpm   Up      0.0.0.0:9000->9000/tcp

Start all services with logs on console (CTRC+C to stop all services):
docker-compose up

Stop and Remove all containers:
docker-compose down

Stopping app_nginx ... done
Stopping app_php   ... done
Stopping app_mysql ... done
Removing app_nginx ... done
Removing app_php   ... done
Removing app_mysql ... done
Removing network app

Test the installation

Open the web browser and go to:

http://localhost:8080

You should be see the output of a a phpinfo() script.

<?php phpinfo() ?>

Usage

Folders

Path	Description
./docker	Docker Files
./log	Services Log
./opt	Shared folder
./www/public	Document Root

So, you can:

check the logs from container services
add your files shared with all containers
working on your app files in the document root

Commands

open bash on linux container for commands execution:
docker-compose exec linux bash

🐳 [app_linux ~]# exit

exec commands from host on linux container:

docker-compose exec linux bash -c 'cat /etc/os-release'
docker-compose exec linux bash -c 'bash --version'

open bash on mysql container for commands execution:
docker-compose exec mysql bash

🐳 [app_mysql mysql]# mysql --version
mysql  Ver 15.1 Distrib 10.5.9-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

open mysql console from host on mysql container (no password required):
docker-compose exec mysql mysql

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 5
Server version: 10.5.9-MariaDB-1:10.5.9+maria~focal mariadb.org binary distribution

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [app]>

open bash on php container for commands execution:
docker-compose exec php bash

🐳 [app_php www]# php -v
PHP 8.0.3 (cli) (built: Mar  6 2021 03:38:04) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.3, Copyright (c) Zend Technologies

🐳 [app_php www]# composer -V
Composer version 2.0.11 2021-02-24 14:57:23

🐳 [app_php www]# symfony -V
Symfony CLI version v4.23.2 (2021-03-02T17:16:03+0000 - stable)

exec commands from host on php container:

docker-compose exec php php -v
docker-compose exec php composer -V
docker-compose exec php symfony -V

ricfio / docker-lemp