Wordpress Docker image running on Alpine Linux

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

Alpine Version 3.16.1 (Released 2022-07-18)

Wordpress Version latest

PHP Version 8.0.22

Nginx Version 1.22.0

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 and you can see how their mantra fits in right at home with Docker images.

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

:amd64, :x86_64 - 64 bit Intel/AMD (x86_64/amd64)
:arm64v8, :aarch64 - 64 bit ARM (ARMv8/aarch64)
:arm32v7, :armhf - 32 bit ARM (ARMv7/armhf)

PLEASE CHECK TAGS BELOW FOR SUPPORTED ARCHITECTURES, THE ABOVE IS A LIST OF EXPLANATION

Tags

:latest latest branch based (Automatic Architecture Selection)
:amd64, :x86_64 amd64 based on latest tag but amd64 architecture
:aarch64, :arm64v8 Armv8 based on latest tag but arm64 architecture
:armhf, :arm32v7 Armv7 based on latest tag but arm32 architecture

Layers & Sizes

Volume structure

/usr/html: Webroot

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

E.G

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, the files should be set to this: User ID: Group ID:

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

E.G

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

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

The following user and group id are used, the files should be set to this:

User ID:

Group ID:

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

WP-CLI

This image now includes WP-CLI wpcli.org baked in... Its 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 redirect);

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 php.ini variable, simply edit php-fpm.ini and add php_flag[variable] = value.

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 do, (leave out the version number i.e. -5.6.11-r0

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

Example:

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

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

Source Repositories

Container Registries

Links

Donation

ooaklee/alpine-php-wordpress

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages