46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# 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.
|