wordpress/README.md

WordPress Docker Image

Custom WordPress Docker image with Redis and APCu extensions for object caching.

Features

• Based on official wordpress:php8.4 image
• Redis extension for external object caching
• APCu extension for in-memory caching
• WP-CLI pre-installed for command-line WordPress management

Usage

Pull from Registry

docker pull your-registry.com/wordpress:latest

Build Locally

docker build -t wordpress-custom .

Run

docker run -d \
  -p 8080:80 \
  -e WORDPRESS_DB_HOST=db \
  -e WORDPRESS_DB_USER=wordpress \
  -e WORDPRESS_DB_PASSWORD=secret \
  -e WORDPRESS_DB_NAME=wordpress \
  wordpress-custom

Docker Compose Example

services:
  wordpress:
    build: .
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: secret
      WORDPRESS_DB_NAME: wordpress
    depends_on:
      - db
      - redis

  db:
    image: mariadb:11
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: secret

  redis:
    image: redis:7-alpine

Build Arguments

Argument	Default	Description
PHP_VERSION	8.4	PHP version to use

docker build --build-arg PHP_VERSION=8.3 -t wordpress-custom .

CI/CD

This repository includes a Gitea Actions workflow that automatically builds and pushes the image.

Required Secrets

Secret	Description
REGISTRY_USERNAME	Container registry username
REGISTRY_PASSWORD	Container registry password/token

Optional Variables

Variable	Default	Description
REGISTRY	gitea.example.com	Container registry URL
IMAGE_NAME	Repository name	Custom image name

Trigger Events

• Push to main or master branch
• Version tags (v*)
• Pull requests (build only, no push)