Dokku WordPress

A simple guide to deploy the official WordPress docker image on Dokku.

Installation

Create a new app on your Dokku server

dokku apps:create my-wordpress

Create a new database for your app

dokku mariadb:create my-wordpress-db

Link the database to your app

dokku mariadb:link my-wordpress-db my-wordpress

Create a new storage for your app

dokku storage:ensure-directory my-wordpress

# Create WordPress content directory
sudo mkdir /var/lib/dokku/data/storage/my-wordpress/wp-content
sudo chown -R dokku:dokku /var/lib/dokku/data/storage/my-wordpress/wp-content

Mount the storage to your app

dokku storage:mount my-wordpress /var/lib/dokku/data/storage/my-wordpress/wp-content:/var/www/html/wp-content

Set environment variables for your app

Replace the values with the results from mariadb:link

# Should look like this
#mysql://<user>:<password>@<host>:<port>/<database>
mysql://mariadb:c89bf4a35681cb17@dokku-mariadb-my-wordpress-db:3306/my_wordpress_db

dokku config:set my-wordpress \
  WORDPRESS_DB_HOST=REPLACE_ME \
  WORDPRESS_DB_USER=REPLACE_ME \
  WORDPRESS_DB_PASSWORD=REPLACE_ME \
  WORDPRESS_DB_NAME=MY-WORDPRESS-DB \

  # The following are optional

  WORDPRESS_DEBUG=false \
  WORDPRESS_CONFIG_EXTRA= \

Port mapping

# dokku proxy:set my-wordpress nginx

dokku proxy:ports-add my-wordpress http:80:80 https:443:80

dokku proxy:build-config my-wordpress

Deploy your app

dokku git:from-image my-wordpress wordpress:6.1.1-php8.1

Configure WordPress (optional)

dokku config:set my-wordpress WORDPRESS_CONFIG_EXTRA="
/* Performance */
define('WP_CACHE', true);
define('COMPRESS_CSS', true);
define('COMPRESS_SCRIPTS', true);
define('CONCATENATE_SCRIPTS', false);
define('ENFORCE_GZIP', true);
/* WP */
define('WP_POST_REVISIONS', false);"

Configure PHP (optional)

First create the directory

sudo mkdir /var/lib/dokku/data/storage/my-wordpress/config
sudo chown -R dokku:dokku /var/lib/dokku/data/storage/my-wordpress/config

Create a file named php-config.ini with the following content:

sudo nano /var/lib/dokku/data/storage/my-wordpress/config/php-config.ini

file_uploads = On
upload_max_filesize = 512M
post_max_size = 512M

; Disable X-Powered-By
expose_php = Off

; Optional
memory_limit = 256M
max_execution_time = 300

Mount the file to your app

dokku storage:mount my-wordpress /var/lib/dokku/data/storage/my-wordpress/config/php-config.ini:/usr/local/etc/php/conf.d/99-php-config.ini

Configure Nginx (optional)