jsntwdj/alpine-php8.4.27-wordpress repository overview

⁠WordPress Container Image Running on Alpine Linux

Docker Automated build · Docker Pulls · Docker Stars

Alpine Version: 3.23.0 (Released 2025-12-03)
WordPress Version: latest
PHP Version: 8.4.27
Nginx Version: 1.28.0

This Container image (yobasystems/alpine-php-wordpress) is based on the minimal Alpine Linux ready for running WordPress. Requires external database.

⁠Table of Contents

• What is Alpine Linux?
• What is WordPress?
• Features
• Architectures
• Tags
• Layers & Sizes
• How to use this image
• Image contents & Vulnerability analysis
• Source Repositories
• Container Registries
• Links
• Donation

⁠🏔️ What is Alpine Linux?

Alpine Linux is a Linux distribution built around musl libc and BusyBox. The image is only 5 MB in size and has access to a package repository that is much more complete than other BusyBox based images. This makes Alpine Linux a great image base for utilities and even production applications.

Read more about Alpine Linux here⁠.

⁠What is WordPress?

WordPress is an online, open source website creation tool written in PHP. But in non-geek speak, it's probably the easiest and most powerful blogging and website content management system (or CMS) in existence today.

⁠✨ Features

• Minimal size only, minimal layers
• Memory usage is minimal on a simple install

⁠🏗️ Architectures

⁠🏷️ Tags

⁠📏 Layers & Sizes

⁠Volume structure

/usr/html: Webroot

⁠🚀 How to use this image

⁠Creating an instance

Make sure you create the folder on the host before starting the container and obtain the correct permissions.

mkdir -p /data/{domain}/html

docker run -e VIRTUAL_HOST={domain}.com,www.{domain}.com \
  -v /data/{domain}/html:/usr/html \
  -p 80:80 \
  yobasystems/alpine-php-wordpress

Example:

mkdir -p /data/yobasystems/html

docker run -e VIRTUAL_HOST=yobasystems.co.uk,www.yobasystems.co.uk \
  -v /data/yobasystems/html:/usr/html \
  -p 80:80 \
  yobasystems/alpine-php-wordpress

The following user and group ID are used; files should be set to this:

• User ID: 100
• Group ID: 101

chown -R 100:101 /data/{domain}/html

Example:

chown -R 100:101 /data/yobasystems/html

Populate /data/{domain}/html with your WordPress files.

The following user and group ID are used; files should be set to this:

• User ID: 100
• Group ID: 101

chown -R 100:101 /data/{domain}/html

⁠WP-CLI

This image now includes WP-CLI (wp-cli.org) baked in. It is best to su nginx before executing anything, or else you can potentially compromise your host.

docker exec -it <container_name> bash
su nginx
cd /usr/html
wp-cli core download --locale=en_GB

⁠Redis Cache

Edit the wp-config.php file and include the line:

define('WP_REDIS_HOST', 'redis');

The next thing is to install the plugin Redis Object Cache.

⁠SSL behind a proxy

If using SSL and running behind a proxy like HAProxy, then the following needs to be added to the wp-config.php file to stop infinite redirects:

define('FORCE_SSL_ADMIN', true);
if (strpos($_SERVER['HTTP_X_FORWARDED_PROTO'], 'https') !== false)
   $_SERVER['HTTPS']='on';

⁠Upload limit

The upload limit is 128 Megabytes.

⁠Change php.ini value

Modify files/php-fpm.conf.

To modify a php.ini variable, simply edit php-fpm.ini and add:

php_flag[variable] = value

Example:

php_flag[display_errors] = on

⁠PHP Modules

List of available modules in Alpine Linux; not all these are installed.

In order to install a PHP module, use the following command. Leave out the version number, e.g. -5.6.11-r0.

docker exec <image_id> apk add <pkg_name>
docker restart <image_name>

Example:

docker exec <image_id> apk add php84-soap
docker restart <image_name>

Available modules:

• php84-common
• php84-pdo_sqlite
• php84-pear
• php84-ftp
• php84-imap
• php84-mysqli
• php84-json
• php84-mbstring
• php84-soap
• php84-litespeed
• php84-sockets
• php84-bcmath
• php84-opcache
• php84-dom
• php84-zlib
• php84-gettext
• php84-fpm
• php84-intl
• php84-openssl
• php84-session
• php84-pdo_mysql
• php84-embed
• php84-xmlrpc
• php84-wddx
• php84-dba
• php84-ldap
• php84-xsl
• php84-exif
• php84-pdo_dblib
• php84-bz2
• php84-pdo
• php84-pspell
• php84-sysvmsg
• php84-gmp
• php84-apache2
• php84-pdo_odbc
• php84-shmop
• php84-ctype
• php84-phpdbg
• php84-enchant
• php84-sysvsem
• php84-sqlite3
• php84-odbc
• php84-pcntl
• php84-calendar
• php84-xmlreader
• php84-snmp
• php84-zip
• php84-posix
• php84-iconv
• php84-curl
• php84-doc
• php84-gd
• php84-xml
• php84-dev
• php84-cgi
• php84-sysvshm
• php84-pgsql
• php84-tidy
• php84-pdo_pgsql
• php84-phar
• php84-mysqlnd

⁠Docker Compose example

wordpress:
  image: yobasystems/alpine-php-wordpress
  environment:
    VIRTUAL_HOST: example.co.uk
  expose:
    - "80"
  volumes:
    - /data/example/www:/usr/html
  restart: always
  links:
    - mysql:mysql
mysql:
  environment:
    MYSQL_DATABASE: wordpressdb
    MYSQL_PASSWORD: wordpresspass
    MYSQL_ROOT_PASSWORD: ''
    MYSQL_USER: wordpressuser
  image: yobasystems/alpine-mariadb

⁠🔍 Image contents & Vulnerability analysis

⁠📚 Source Repositories

• GitHub: yobasystems/alpine-php-wordpress
• GitLab: yobasystems/alpine-php-wordpress

⁠🐳 Container Registries

• Docker Hub: yobasystems/alpine-php-wordpress
• Quay.io: yobasystems/alpine-php-wordpress
• GHCR: yobasystems/alpine-php-wordpress

⁠🔗 Links

• Yoba Systems
• GitHub: Yoba Systems
• Docker Hub: Yoba Systems
• Quay.io: Yoba Systems
• GHCR: Yoba Systems
• Maintainer: Dominic Taylor

⁠Donation