Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Docker Stack

PHP 8 MariaDB nginx Redis Laravel ready!

This repo contains a simple Docker setup you can drop into many PHP-based projects without the configuration and tweaking hassle. Find out more about the idea behind this in my blog post.


The stack consists of four files from those two are configuration files and one is the .env file you can find in many projects.

Directory structure

├─ docker
│  ├─ php.ini
│  └─ nginx.conf
├─ // Your other app files
├─ .env
└─ docker-compose.yml

My default setup consists of PHP, MariaDB as a MySQL-compatible database server, nginx and Redis. All services are defined in the docker-compose.yml file.

Part of the docker-compose

# --- PHP
  container_name: "project-php"
  image: bitnami/php-fpm:8.1
    - .:/app:delegated
    - ./docker/php.ini:/opt/bitnami/php/etc/conf.d/php.ini:ro

# --- nginx
  container_name: "project-nginx"
  image: bitnami/nginx:1.21
    - ""
    - php
    - .:/app:delegated
    - ./docker/nginx.conf:/opt/bitnami/nginx/conf/server_blocks/site.conf:ro

This is the definition of the PHP and nginx containers. As you can see it runs with PHP 8. The only things it does is to make the project available in the /app directory (the base directory for all Bitnami containers) and apply your custom php.ini.

Current Service Versions

Service Version
PHP 8.1
MariaDB 10.7
nginx 1.21
Redis 6.2

Setup & Configuration

In most cases you only have to change the .env file because it contains variable details about the stack and passwords. The main stack works for all plain PHP projects, but you can easily make it work with Laravel or any CMS by changing the nginx.conf file because each system may has different requirements on the web server configuration.

Installation and usage

  • Copy the main files (everything except /public, /.github and to your project
  • Make a copy of the .env.example file and name it .env, or copy the needed values to your existing .env file. Laravel users do not have to copy anything.
  • Make sure the current configuration matches your project setup. CMS like Wordpress or Drupal need additional configuration.
  • Replace dockerstack with your own project name in the APP_NAME variable in the .env file.
  • Run docker-compose up -d.

Docker will then download all images and start them up. By default, port 80 on your host machine is bound to nginx, so you should be able to access your app by opening http://localhost in your browser.

The database is accessible from your local machine only via port 3306.

Docker Stack is a project by Kovah | Contributors