Docker-Laravel-Redis-Postgres-Nginx

Simple docker env, for local development.

About build:

• composer (Dockerfile, project-init and start-entrypoint scripts)

  load clean laravel project blade template if not exists in ./app, or update vendor

• app (Dockerfile and start-entrypoint)

  run after pre-build stage, create laravel-fpm container and serve by php-fpm (load www.conf, and php.ini from ./php)

• cache (redis-alpine)

• web (nginx-alpine)

  edit default.config.template in ./nginx/templates/

• adm (adminer)

  works with mysql, postgres etc (change driver before login)

• db (postgres:alpine)

• example ‘.env’ config for build

  .env holds all build env every service (overrites laravel .env file)

Pre-build stage

Before run you should install docker on your PC.

How install docker, official docs

Checkout docker already installed, just run in terminal and you get docker version info

docker -v

Run composer service before and load laravel project source (build composer image and load empty laravel project)

docker compose up -d composer

Add vite server (serve all resource stuff styles & scripts) into app/vite.config.js

if no permissions for edit file change owner (default owner - www)

sudo chown <your_user> app/vite.config.js

Show all default config file

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import tailwindcss from '@tailwindcss/vite';

// combine all vite environment variables and default values
const vite = {
    'host': process.env.VITE_HOST ?? '0.0.0.0',
    'port': process.env.VITE_PORT ?? 5173,
    'appPort': process.env.APP_PORT ?? 8000,
    'appUrl': process.env.APP_URL ?? 'localhost',
    'base': process.env.VITE_BASE ?? '/app/',
};

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/css/app.css', 'resources/js/app.js'],
            refresh: true,
        }),
        tailwindcss(),
    ],
    
    // add this vite server section 
    server: {
        // respond to all network requests
        host: vite.host,
        port: vite.port,
        base: vite.base,
        strictPort: true,
        // all outside requests to port 5173 pass throw artisan server to nginx
        proxy:{
            '^(?!(\/\@vite|\/resources|\/node_modules))': {
                target: `http://${vite.appUrl}:${vite.appPort}`,
            }
        },
        hmr: {'host':vite.appUrl, 'port':vite.port},
        // Defines the origin of the generated asset URLs during development,
        // this will also be used for the public/hot file (Vite devserver URL)
        cors: {
            origin: [
                `http://${vite.appUrl}:8000`, // dev server cors
                `http://${vite.appUrl}:80`,
                `http://${vite.appUrl}`,
            ]
        },
    }
});

Then remove composer service final pre-build stage

docker compose down --remove-orphans

Workflow

Run docker compose up

docker compose up -d

And now checkout in browser:

Adminer if want edit database manually

Nginx proxy for services (laravel-app)

Laravel official framework info

Laravel access on default port nginx, but serve by php-fpm server, settings edit in www.conf in ./php

Permission problem

You can add root access for your user (host machine)

alpine www-data user assign to 82 id, so create new user with same name group with same id on your host machine (example for ubuntu)

sudo groupadd -g 82 www
sudo useradd -u 82 -g 82 www

Now add your current user (host machine) into www group for full permission

sudo usermod -a -G www [user-name]

Add full permission for your user, use command as root (sudo) -R flag (recursive run)

sudo chown -R [user-name]:www /path/to/your/local/folder

How return default permission

This will return all back, use command as root (sudo) -R flag (recursive run)

sudo chown -R www /path/to/your/local/folder

Help tools

• Gitignore generator helps generate gitignore for your lang, ide, or framework.