Skip to content

joepurdy/DockPress

Repository files navigation

DockPress is a dockerized version of WordPress inspired heavily by the Roots.io approach to managing a modern WordPress application.

Features

  • Pre-defined development workflow using a single script
  • Support for simple initialization of Bedrock and Sage
  • Composer package management
  • WP-CLI commands for easier administration

Requirements

Installation

  1. Run the initialization command with the develop script:

./develop init your-theme-name

  1. Update environment variables in src/.env file:
  • DB_NAME - Database name
  • DB_USER - Database user
  • DB_PASSWORD - Database password
  • DB_HOST - Database host
  • WP_ENV - Set to environment (development, staging, production)
  • WP_HOME - Full URL to WordPress home (http://example.dev)
  • WP_SITEURL - Full URL to WordPress including subdirectory (http://example.dev/wp)
  • AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT - Generate these at https://roots.io/salts.html

The develop script sets defaults for the DB environment variables so if you aren't using custom values you should specify the following values:

DB_NAME=wordpress
DB_USER=wordpress
DB_PASSWORD=secret
DB_HOST=mysql
  1. Bring the Docker environment online with ./develop up -d

  2. Create an entry in your hostfile mapping the WP_HOME address to 127.0.0.1

  3. Access WP admin at http://example.dev/wp/wp-admin

Contributing

Contributions are welcome from everyone. I don't consider myself an expert here since I only work on WordPress projects once in a blue moon. Check out the contributing guidelines to help you get started.

Sponsor this project

Languages