From bdc22a45a4445e1d2b0c7e9bc4e038c90a539d84 Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Wed, 13 May 2026 22:44:58 -0300 Subject: [PATCH 1/2] docs: add project introduction before setup tutorial Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 481cf0a..ab9a8f0 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,19 @@ # Wordpress +## About this project + +This repository provides a reproducible Docker environment for running a WordPress stack used by LibreSign and related integrations. + +The main goal is to make local development, onboarding, and environment recovery fast and predictable, without manual server setup. + +It is useful when you need to: +- Run WordPress with MariaDB and Nginx in a consistent way across machines. +- Import production-like data and remap URLs for local usage. +- Install plugins and themes automatically, including custom Git repositories. +- Configure local integrations (for example SMTP with mailpit, or other plugin-specific settings) during startup. + +In short, this project reduces setup friction and keeps local behavior close to real deployment scenarios. + [It will be necessary to have the docker installed in its operating system to execute this project.](https://docs.docker.com/get-docker/) From 2c1e16350e05f64bbdab5a24552bb00292e69a05 Mon Sep 17 00:00:00 2001 From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> Date: Wed, 13 May 2026 22:50:50 -0300 Subject: [PATCH 2/2] docs: refine README intro and add database dump section Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com> --- README.md | 30 ++++++++++++++++++++++-------- 1 file changed, 22 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ab9a8f0..cd9958d 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,16 @@ # Wordpress -## About this project +This repository provides a Docker setup to run a WordPress stack with plugins and themes. -This repository provides a reproducible Docker environment for running a WordPress stack used by LibreSign and related integrations. - -The main goal is to make local development, onboarding, and environment recovery fast and predictable, without manual server setup. +The main goal is to make local development, onboarding, and environment recovery quick, without manual server setup. It is useful when you need to: -- Run WordPress with MariaDB and Nginx in a consistent way across machines. +- Run WordPress with MariaDB and Nginx the same way on any machine. - Import production-like data and remap URLs for local usage. - Install plugins and themes automatically, including custom Git repositories. - Configure local integrations (for example SMTP with mailpit, or other plugin-specific settings) during startup. -In short, this project reduces setup friction and keeps local behavior close to real deployment scenarios. - -[It will be necessary to have the docker installed in its operating system to execute this project.](https://docs.docker.com/get-docker/) +Prerequisite: [Docker](https://docs.docker.com/get-docker/) must be installed on your operating system. ## Setup @@ -96,6 +92,24 @@ docker compose up -d --build docker compose exec --user www-data wordpress wp user reset-password --show-password --skip-email ``` +### Database dump + +If you need to bootstrap the environment with existing data, place your SQL dump in the folder below: + +`volumes/mariadb/dump/` + +How it works: +- Files in this folder are mounted at `/docker-entrypoint-initdb.d` inside MariaDB. +- They are imported automatically only when the MariaDB data directory is empty (first initialization). + +If your database is already initialized and you want to import a dump manually: + +```bash +docker compose exec -T mariadb sh -lc 'mariadb -uroot -p"$MARIADB_ROOT_PASSWORD" "$MARIADB_DATABASE"' < volumes/mariadb/dump/your-dump.sql +``` + +If you want to force automatic re-import from `/docker-entrypoint-initdb.d`, remove the existing database files in `volumes/mariadb/data` and start the stack again. + ### Local e-mail (mailpit) When you add the `mailpit` service to your override, all outgoing WordPress e-mails are captured and visible at .