arivum/wordpress repository overview

⁠Basics

Our image is similar to the official WordPress image. It extends:

• php mail (two additional environment variables to configure mailing)
• set maximum upload size via environment variable
• caddy replaces apache and all images are based on alpine (so they are pretty small)
• avoids copy-on-startup mechanism of the official image
• php-ldap module to make use of LDAP authentication plugins in WordPress
• volumes: /var/www/html/wp-content/plugins and /var/www/html/wp-content/uploads

⁠Good to know

To avoid redundant information we recommend to use the official Documentation⁠. Most tips, tricks and workarounds that work for the official image will also work for our image.

⁠How to use our image

(excerpt of the official Documentation⁠)

$ docker run --name some-wordpress --link some-mysql:mysql -d wordpress

The following environment variables are only avaiable for configuring our image:

• -e WORDPRESS_PLUGINS=... (space seperated list of plugin names, version via pluginname:version)
• -e WORDPRESS_ADMIN_MAIL_ADDRESS=... (defaults to "", mailing via ssmtp only available if set)
• -e WORDPRESS_MAILSERVER_HOST=... (defaults to "", mailing via ssmtp only available if set)
• -e WORDPRESS_UPLOAD_SIZE=... (defaults to "64M", must be number and suffix of type k,M or G)

The following environment variables are also honored for configuring your WordPress instance:

• -e WORDPRESS_DB_HOST=... (defaults to the IP and port of the linked mysql container)
• -e WORDPRESS_DB_USER=... (defaults to "root")
• -e WORDPRESS_DB_PASSWORD=... (defaults to the value of the MYSQL_ROOT_PASSWORD environment variable from the linked mysql container)
• -e WORDPRESS_DB_NAME=... (defaults to "wordpress")
• -e WORDPRESS_TABLE_PREFIX=... (defaults to "", only set this when you need to override the default table prefix in wp-config.php)
• -e WORDPRESS_AUTH_KEY=..., -e WORDPRESS_SECURE_AUTH_KEY=..., -e WORDPRESS_LOGGED_IN_KEY=..., * -e WORDPRESS_NONCE_KEY=..., -e WORDPRESS_AUTH_SALT=..., -e WORDPRESS_SECURE_AUTH_SALT=..., -e WORDPRESS_LOGGED_IN_SALT=..., -e WORDPRESS_NONCE_SALT=... (default to unique random SHA1s)
• -e WORDPRESS_DEBUG=1 (defaults to disabled, non-empty value will enable WP_DEBUG in wp-config.php)
• -e WORDPRESS_CONFIG_EXTRA=... (defaults to nothing, non-empty value will be embedded verbatim inside wp-config.php -- especially useful for applying extra configuration values this image does not provide by default such as WP_ALLOW_MULTISITE; see docker-library/wordpress#142 for more details)