Minimal, cloud-native, battle-tested WordPress environment meant to be used both in local development and staging/production.
Images are published as multi-arch manifests for linux/amd64 and linux/arm64 (e.g. Apple Silicon, AWS Graviton, Raspberry Pi 4/5 with a 64-bit OS). Docker pulls the right variant automatically.
Each image is published under three tags on Docker Hub:
| Tag | Example | Moves when |
|---|---|---|
<image>-alpine | wordpress-alpine | every release |
<image>-<version>-alpine | wordpress-7.1.3-alpine | every release of that upstream WordPress/NGINX version |
<image>-<version>-alpine-<commit> | wordpress-7.1.3-alpine-83cf25e | never: pin this one to roll back or to deploy a known build |
A release is published only after both architectures pass the smoke test (see Testing), and only for the images whose directory changed.
# Clone the repo
git clone https://github.com/gioamato/stateless-wordpress.git
cd stateless-wordpress
# Spin it up with Docker Compose
docker compose up -d
# Open your browser and head to http://localhost:8080
# You will find the famous WordPress 5-minute install
# Deploy with kubectl
kubectl apply -f https://raw.githubusercontent.com/gioamato/stateless-wordpress/master/deploy/kubernetes/deploy.yaml
# The namespace 'stateless-wordpress' is created to host the example resources:
# - 1 Stateful MySQL replica with emptyDir volume (data lost on restart)
# - 3 Stateless WordPress replicas (horizontal scaling)
# - A Secret storing WordPress Enviroment Configuration
# - A Service with type LoadBalancer to expose the app
# Open your browser and head to the service External IP
# You will find the famous WordPress 5-minute install
Every pull request runs the same checks you can run locally (only Docker is required):
# Lint Dockerfiles, shell scripts and workflows, and check composer.lock is in sync
tests/lint.sh
# Build both images, start the stack and test it end to end:
# env-based PHP/FPM config, WordPress install, bundled plugins/theme/translations,
# FastCGI cache, NGINX access rules and clean PHP/NGINX logs
tests/smoke.sh
The smoke test uses its own Compose project and port (SMOKE_PORT, default 8089), so it can run next to the local development stack.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Content type
Image
Digest
sha256:24aa83128…
Size
115.3 MB
Last updated
13 days ago
docker pull gioamato/stateless-wordpress:wordpress-7.1.3-alpine-2d1cdcc