Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/adhocore/docker-lemp

A single container LEMP complete fullstack with latest release of PHP8.0.30/8.1.29/8.2.23/8.3.11, MySQL, nginx, PostgreSQL, mailcatcher, beanstalkd, elasticsearch, memcached, redis, adminer and all you ever need; on top alpine3.17+ for both arm and amd arch
https://github.com/adhocore/docker-lemp

adhocore alpine-linux beanstalkd docker docker-lemp docker-php elasticsearch lemp local-development mailcatcher memcached mysql nginx php8 phpfpm postgres redis stack

Last synced: 3 days ago
JSON representation

A single container LEMP complete fullstack with latest release of PHP8.0.30/8.1.29/8.2.23/8.3.11, MySQL, nginx, PostgreSQL, mailcatcher, beanstalkd, elasticsearch, memcached, redis, adminer and all you ever need; on top alpine3.17+ for both arm and amd arch

Awesome Lists containing this project

README 

        
## docker-lemp



[![Docker build](https://github.com/adhocore/docker-lemp/actions/workflows/build.yml/badge.svg)](https://github.com/adhocore/docker-lemp/actions/workflows/build.yml)

[![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Complete+LEMP+fullstack+for+local+development+using+docker&url=https://github.com/adhocore/docker-lemp&hashtags=docker,lemp,fullstack,localdev)

[![Support](https://img.shields.io/static/v1?label=Support&message=%E2%9D%A4&logo=GitHub)](https://github.com/sponsors/adhocore)



> Do not use this LEMP in Production.

> For production, use [adhocore/phpfpm](https://github.com/adhocore/docker-phpfpm)

> then [compose](https://docs.docker.com/compose/install/) a stack using individual `nginx`, `redis`, `mysql` etc images.



[`adhocore/lemp`](https://hub.docker.com/r/adhocore/lemp) is a minimal single container LEMP full stack for local development.



It is quick jumpstart for onboarding you into docker based development.

The download size is just about ~350MB which is tiny considering how much tools and stuffs it contains.



The docker container `adhocore/lemp` is composed of:



Name             | Version    | Port

-----------------|------------|------

adminerevo       | 4.8.4      | 80

alpine           | 3.16       | -

beanstalkd       | 1.12       | 11300

elasticsearch    | 6.4.3      | 9200,9300

mailcatcher      | 0.7.1      | 88,25

memcached        | 1.6.15     | 11211

MySQL`*`         | 5.7        | 3306

nginx            | 1.21.1     | 80

~phalcon~`"`     | 5.0.3      | -

PHP8.3`+`        | >=8.3.4    | 9000

PHP8.2`+`        | >=8.2.17   | 9000

PHP8.1`+`        | >=8.1.27   | 9000

PHP8.0`+`        | >=8.0.30   | 9000

PHP7.4`~`        | >=7.4.33   | 9000

PostgreSQL       | 14.7       | 5432

~rabbitmq~`^`    | 3.8.*      | 5672

redis            | 7.0.10     | 6379

~swoole~`"`      | 4.8.9      | -



> `*`: Actually [MariaDB 10.6.12](https://mariadb.com/kb/en/mariadb-vs-mysql-compatibility/).



> `+`: Different image tags each, viz `:8.3`, `:8.2`, `:8.1`, `:8.0` and `:7.4`.



> `~`: PHP 7.4 has reached end of life and is **deprecated**.



> `"`: swoole, phalcon have been disabled for now in order to optimize and speed up multiplatform builds (amd64/arm64) but can be [added back](https://github.com/adhocore/docker-lemp/issues/41#issuecomment-1639873818).



## Usage



Install [docker](https://docs.docker.com/install/) in your machine.

Also recommended to install [docker-compose](https://docs.docker.com/compose/install/).



```sh

# pull latest image

docker pull adhocore/lemp:8.3



# or with PHP8.2

docker pull adhocore/lemp:8.2



# or with PHP8.1

docker pull adhocore/lemp:8.1



# or with PHP8.0

docker pull adhocore/lemp:8.0



# or if you *still* use php 7.4 (which you should not):

docker pull adhocore/lemp:7.4



# Go to your project root then run

docker run -p 8080:80 -p 8888:88 -v `pwd`:/var/www/html --name lemp -d adhocore/lemp:8.3



# In windows, you would use %cd% instead of `pwd`

docker run -p 8080:80 -p 8888:88 -v %cd%:/var/www/html --name lemp -d adhocore/lemp:8.3



# If you want to setup MySQL credentials, pass env vars

docker run -p 8080:80 -p 8888:88 -v `pwd`:/var/www/html \

  -e MYSQL_ROOT_PASSWORD=1234567890 -e MYSQL_DATABASE=appdb \

  -e MYSQL_USER=dbuser -e MYSQL_PASSWORD=123456 \

  --name lemp -d adhocore/lemp:8.2

  # for postgres you can pass in similar env as for mysql but with PGSQL_ prefix

```



After running container as above, you will be able to browse [localhost:8080](http://localhost:8080)!



The database adminerevo will be available for [mysql](http://localhost:8080/adminerevo?server=127.0.0.1%3A3306&username=root)

and [postgres](http://localhost:8080/adminerevo?pgsql=127.0.0.1%3A5432&username=postgres).



The mailcatcher will be available at [localhost:8888](http://localhost:8888) which displays mails in realtime.



### Stop container



To stop the container, you would run:



```sh

docker stop lemp

```



### (Re)Start container



You dont have to always do `docker run` as in above unless you removed or lost your `lemp` container.



Instead, you can just start when needed:



```sh

docker start lemp

```



> **PRO** If you develop multiple apps, you can create multiple lemp containers with different names.

>

> eg: `docker run -p 8081:80 -v $(pwd):/var/www/html --name new-lemp -d adhocore/lemp:8.3`



## With Docker compose



Create a `docker-compose.yml` in your project root with contents something similar to:



```yaml

# ./docker-compose.yml

version: '3'



services:

  app:

    image: adhocore/lemp:8.3

    # For different app you can use different names. (eg: )

    container_name: some-app

    volumes:

      # app source code

      - ./path/to/your/app:/var/www/html

      # db data persistence

      - db_data:/var/lib/mysql

      # Here you can also volume php ini settings

      # - /path/to/zz-overrides:/usr/local/etc/php/conf.d/zz-overrides.ini

    ports:

      - 8080:80

    environment:

      MYSQL_ROOT_PASSWORD: supersecurepwd

      MYSQL_DATABASE: appdb

      MYSQL_USER: dbusr

      MYSQL_PASSWORD: securepwd

      # for postgres you can pass in similar env as for mysql but with PGSQL_ prefix



volumes:

  db_data: {}

```



Then all you gotta do is:



```sh

# To start

docker-compose up -d



# To stop

docker-compose stop

```



As you can see using compose is very neat, intuitive and easy.

Plus you can already set the volumes and ports there, so you dont have to type in terminal.



### MySQL Default credentials



- **root password**: 1234567890 (if `MYSQL_ROOT_PASSWORD` is not passed)

- **user password**: 123456 (if `MYSQL_USER` is passed but `MYSQL_PASSWORD` is not)



### PgSQL Default credentials



- **postgres password**: 1234567890 (if `PGSQL_ROOT_PASSWORD` is not passed)

- **user password**: 123456 (if `PGSQL_USER` is passed but `PGSQL_PASSWORD` is not)



#### Accessing DB



In PHP app you can access MySQL db via PDO like so:

```php

$db = new PDO(

    'mysql:host=127.0.0.1;port=3306;dbname=' . getenv('MYSQL_DATABASE'),

    getenv('MYSQL_USER'),

    getenv('MYSQL_PASSWORD')

);

```



You can access PgSQL db via PDO like so:

```php

$pdb = new PDO(

    'pgsql:host=127.0.0.1;port=5432;dbname=' . getenv('PGSQL_DATABASE'),

    getenv('PGSQL_USER'),

    getenv('PGSQL_PASSWORD')

);

```



### Nginx



URL rewrite is already enabled for you.



Either your app has `public/` folder or not, the rewrite adapts automatically.



### PHP



For available extensions, check [adhocore/phpfpm#extensions](https://github.com/adhocore/docker-phpfpm#extensions).



### Disabling services



[Pass in env var](https://www.cloudsavvyit.com/14081/how-to-pass-environment-variables-to-docker-containers/)

`DISABLE` to the container in CSV format to disable services.

The service names must be one or more of below in comma separated format:

```

beanstalkd

mailcatcher

memcached

mysql

pgsql

redis

```



> Example: `DISABLE=beanstalkd,mailcatcher,memcached,pgsql,redis`

> Essential services like `nginx`, `php`, `adminerevo` cannot be disabled ;).



The service(s) will be enabled again if you run the container next time without `DISABLE` env or if you remove specific services from `DISABLE` CSV.



### Testing mailcatcher



```sh

# open shell

docker exec -it lemp sh



# send test mail

echo "\n" | sendmail -S 0 test@localhost

```



Then you will see the new mail in realtime at http://localhost:8888.



Or you can check it in shell as well:

```sh



curl 0:88/messages

```