PostgreSQL as default database

README.md

@@ -27,7 +27,7 @@ For this reason, Tailwind has been added into the project and is utilized with t
 ---
 
 ## Usage with Docker
-This starter kit is configured to use Docker Compose for local development with a few extra configuration steps. With this setup, you do not need PHP, Composer, MySQL or Node.js installed on your machine to get up and running with this project.
+This starter kit is configured to use Docker Compose for local development with a few extra configuration steps. With this setup, you do not need PHP, Composer, PostgreSQL or Node.js installed on your machine to get up and running with this project.
 
 ### Setup
 1. In a new directory (outside of your Laravel project) create a `docker-compose.yml` file to create a reverse proxy container using [Traefik](https://doc.traefik.io/traefik/getting-started/quick-start/). You can reference this [example implementation](https://github.com/connorabbas/traefik-docker-compose/blob/master/docker-compose.yml).
@@ -42,20 +42,20 @@ This starter kit is configured to use Docker Compose for local development with
     # Match with value used in docker-compose.local.yml
     APP_URL=http://primevue-inertia.localhost
 
-    DB_CONNECTION=mysql
-    DB_HOST=mysql
-    DB_PORT=3306
+    DB_CONNECTION=pgsql
+    DB_HOST=pgsql # name of service
+    DB_PORT=5432
     DB_DATABASE=laravel
     DB_USERNAME=sail
     DB_PASSWORD=password
 
     # Update as needed for running multiple projects
     APP_PORT=8000
     VITE_PORT=5173
-    FORWARD_DB_PORT=3306
+    FORWARD_DB_PORT=5432
     ```
 3. Build the Laravel app container:
    - Either build manually with docker compose (like above), use [Laravel Sail](https://laravel.com/docs/master/sail), or build as a [VS Code Dev Container](https://code.visualstudio.com/docs/devcontainers/tutorial) using the `Dev Containers: Reopen in Container` command.
 
 ### Additional configuration
-If you wish to add additional services, or swap out MySQL with an alternative database, you can reference the [Laravel Sail stubs](https://github.com/laravel/sail/tree/1.x/stubs) and update the `docker-compose.local.yml` file as needed.
+If you wish to add additional services, or swap out PostgreSQL with an alternative database, you can reference the [Laravel Sail stubs](https://github.com/laravel/sail/tree/1.x/stubs) and update the `docker-compose.local.yml` file as needed.

docker-compose.local.yml

@@ -27,35 +27,29 @@ services:
       - sail
       - proxy
     depends_on:
-      - mysql
+      - pgsql
 
-  mysql:
-    image: 'mysql/mysql-server:8.0'
+  pgsql:
+    image: 'postgres:17'
     ports:
-      - '${FORWARD_DB_PORT:-3306}:3306'
+      - '${FORWARD_DB_PORT:-5432}:5432'
     environment:
-      MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
-      MYSQL_ROOT_HOST: '%'
-      MYSQL_DATABASE: '${DB_DATABASE}'
-      MYSQL_USER: '${DB_USERNAME}'
-      MYSQL_PASSWORD: '${DB_PASSWORD}'
-      MYSQL_ALLOW_EMPTY_PASSWORD: 1
+      PGPASSWORD: '${DB_PASSWORD:-secret}'
+      POSTGRES_DB: '${DB_DATABASE}'
+      POSTGRES_USER: '${DB_USERNAME}'
+      POSTGRES_PASSWORD: '${DB_PASSWORD:-secret}'
     volumes:
-      - 'primevue-inertia-mysql:/var/lib/mysql'
-      - './docker/local/database/mysql/create-testing-database.sh:/docker-entrypoint-initdb.d/10-create-testing-database.sh'
+      - 'primevue-inertia-pgsql:/var/lib/postgresql/data'
+      - './docker/local/database/pgsql/create-testing-database.sql:/docker-entrypoint-initdb.d/10-create-testing-database.sql'
     networks:
       - sail
     healthcheck:
-      test:
-        - CMD
-        - mysqladmin
-        - ping
-        - '-p${DB_PASSWORD}'
+      test: [ "CMD", "pg_isready", "-q", "-d", "${DB_DATABASE}", "-U", "${DB_USERNAME}" ]
       retries: 3
       timeout: 5s
 
 volumes:
-  primevue-inertia-mysql:
+  primevue-inertia-pgsql:
     driver: local
 
 networks:

docker/local/database/pgsql/create-testing-database.sql

@@ -0,0 +1,2 @@
+SELECT 'CREATE DATABASE testing'
+WHERE NOT EXISTS (SELECT FROM pg_database WHERE datname = 'testing')\gexec