# WordPress + Nginx + MariaDB Stack

A production-ready "Quick Start" stack featuring WordPress running via PHP-FPM and Nginx as a reverse proxy.

## 🚀 Quick Start

### 1. Clone the repository
```bash
git clone <your-repo-url>
cd wp-nginx
```

### 2. Setup Environment Variables
This project uses a base + override system for environment variables.
```bash
# Create your local env file from the example
cp .env.example .env
```
Open `.env` and update your passwords. The `docker-compose.yaml` is configured to load `.env.example` first for defaults and `.env` second for your specific overrides.

### 3. Launch the Stack
```bash
docker compose up -d
```

### 4. Access your site
Visit [http://localhost:8000](http://localhost:8000) in your browser to complete the WordPress installation.

---

## 🛠 Architecture

- **Web Server:** Nginx (Stable Alpine)
- **Application:** WordPress (PHP 8.5 FPM Alpine)
- **Database:** MariaDB (Latest)

### Key Features
- **Security:** Nginx configuration is mounted as read-only.
- **Flexibility:** Supports both standard Docker Compose `.env` and Portainer's `stack.env` conventions.
- **Persistence:** Named volumes are used for both database and WordPress content to ensure data survives container restarts.

## 📂 Project Structure
- `docker-compose.yaml`: The orchestration file.
- `.env.example`: Template for required configuration.
- `nginx/default.conf`: Custom Nginx configuration for PHP-FPM proxying.