LAMP Docker ready for OctoberCMS installation

This is a basic LAMP stack environment built using Docker Compose. It consists following:

PHP 7.2
Apache 2.4
MySQL 5.7
phpMyAdmin
OctoberCMS Installer in www folder
Fish shell
Vim editor and a few plugins

Reference

Installation

Start

./run.sh start

Stop

./run.sh stop

Install through browser

http://localhost:port/install.php

Installation guide

NOTE:

The database host is the container name for mysql: 5.7-mysql instead of localhost

Remove the installer after installation

Configuration

This package comes with default configuration options. You can modify them by creating .env file in your root directory.

To make it easy, just copy the content from sample.env file and update the environment variable values as per your need.

Configuration Variables

There are following configuration variables available and you can customize them by overwritting in your own .env file.

DOCUMENT_ROOT

It is a document root for Apache server. The default value for this is ./www. All your sites will go here and will be synced automatically.

MYSQL_DATA_DIR

This is MySQL data directory. The default value for this is ./data/mysql. All your MySQL data files will be stored here.

VHOSTS_DIR

This is for virtual hosts. The default value for this is ./config/vhosts. You can place your virtual hosts conf files here.

Make sure you add an entry to your system's hosts file for each virtual host.

APACHE_LOG_DIR

This will be used to store Apache logs. The default value for this is ./logs/apache2.

MYSQL_LOG_DIR

This will be used to store Apache logs. The default value for this is ./logs/mysql.

Web Server

Apache is configured to run on port 80. So, you can access it via http://localhost.

Apache Modules

By default following modules are enabled.

rewrite
headers

If you want to enable more modules, just update ./bin/webserver/Dockerfile. You can also generate a PR and we will merge if seems good for general purpose. You have to rebuild the docker image by running docker-compose build and restart the docker containers.

Connect via SSH

You can connect to web server using docker exec command to perform various operation on it. Use below command to login to container via ssh.

docker exec -it 7.2.x-webserver /bin/bash

docker exec -it 7.2.x-webserver fish

PHP

The installed version of PHP is 7.2

Extensions

By default following extensions are installed.

mysqli
mbstring
zip
intl
mcrypt
curl
json
iconv
xml
xmlrpc
gd

If you want to install more extension, just update ./bin/webserver/Dockerfile. You can also generate a PR and we will merge if seems good for general purpose. You have to rebuild the docker image by running docker-compose build and restart the docker containers.

phpMyAdmin

phpMyAdmin is configured to run on port 8080. Use following default credentials.

http://localhost:8080/
username: root
password: tiger

TODO:

Optimize to reduce the container size.

zhouhao27 / octobercms-mysql-phmyadmin