initial commit

README.md

@@ -0,0 +1,45 @@
+# 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.