USER_DOC.md

User Documentation - Inception

This document explains how an end user or administrator can use and manage the Inception infrastructure.

Services Provided

1. WordPress: A content management system for creating and managing websites. Accessible via a web browser.
2. NGINX: A web server that acts as the single entry point, providing HTTPS (TLS 1.2/1.3) and reverse proxy functionality.
3. MariaDB: A database system for storing WordPress data, with persistent storage.

---

Starting and Stopping the Project

Prerequisites

1. Docker Installed:

   docker --version
   docker compose version

2. Local Domain Configured: Add the following line to /etc/hosts:

   127.0.0.1    fmorenil.42.fr

3. Environment File: Ensure srcs/.env is configured with the required credentials (see Managing Credentials).

Commands

• Start the Project:

  make

• Stop the Project:

  make stop

• Restart the Project:

  make start

• Remove Containers:

  make down

• Full Cleanup:

  make fclean

---

Accessing the Website and Admin Panel

1. Website:

   • URL: https://fmorenil.42.fr
   • Accept the self-signed SSL certificate in your browser.

2. Admin Panel:

   • URL: https://fmorenil.42.fr/wp-admin
   • Use the admin credentials from the .env file.

---

Managing Credentials

Location

• All credentials are stored in srcs/.env.
• Example structure:

  MYSQL_ROOT_PASSWORD=your_root_password
  MYSQL_DATABASE=wordpress
  MYSQL_USER=your_user
  MYSQL_PASSWORD=your_password
  WORDPRESS_ADMIN_USER=admin
  WORDPRESS_ADMIN_PASSWORD=admin_password

Recommendations

• Use strong passwords.
• Keep the .env file secure and excluded from version control.
• Backup the .env file in a safe location.

---

Checking Service Status

1. List Running Containers:

   docker ps

2. View Logs:

   make logs

3. Check Connectivity:

   curl -k https://fmorenil.42.fr

4. Inspect Docker Network:

   docker network inspect srcs_wordpress_network