Skip to content

USER_DOC.md

Latest commit

 

History

History
34 lines (28 loc) · 1.52 KB

USER_DOC.md

File metadata and controls

34 lines (28 loc) · 1.52 KB

Services

This stack runs three containers:

  • Nginx: TLS (443) reverse proxy serving the WordPress site.
  • WordPress (php-fpm): Handles PHP rendering for the site.
  • MariaDB: Stores the WordPress database.

Start & Stop the project

From the repository root:

  • Start (build + run): make up
  • Stop (keep volumes): make down
  • Rebuild and restart: make re

Accessing the site and admin

Credentials (location & management)

  • Non-sensitive config (usernames, database names, domain): srcs/.env (git-ignored)
  • Passwords & secrets: secrets/ directory at project root (git-ignored). Each secret file contains only the password string, e.g.:
    • secrets/db_password.txt - MariaDB user password
    • secrets/db_root_password.txt - MariaDB root password
    • secrets/wp_admin_password.txt - WordPress admin password
    • secrets/wp_user_password.txt - WordPress regular user password
  • Database and WP data live on host bind mounts at ${HOST_DATA_ROOT} (default /home/yel-bouz/data):
    • WordPress files: ${HOST_DATA_ROOT}/wp_data
    • MariaDB data: ${HOST_DATA_ROOT}/db_data

Checking service health

  • Container status: cd srcs && docker compose ps
  • Nginx reachability: curl -k -I https://localhost
  • WordPress running: open the site or curl -k https://localhost | head
  • Logs (by service): cd srcs && docker compose logs <service> (e.g., nginx, wordpress, mariadb)