verzola/dockerpress repository overview

⁠:whale: :newspaper: DockerPress

Fast Wordpress environment based on Docker.

WARNING: This tool is under development. Use at your own risk. :warning:

⁠Table of contents

1. Features⁠
2. Requirements⁠
3. Setup⁠
4. Environment variables⁠
5. Helpers⁠
6. Mail⁠
7. Plugins⁠
8. Known issues⁠
9. Contribuiting⁠
10. TODO⁠

⁠:trophy: Features

• :newspaper: Wordpress 5.2
• :elephant: PHP 7.3
• Nginx 1.17
• :dolphin: MySQL 8
• :musical_score: Composer⁠
• :mailbox: Mailhog⁠
• WP-CLI⁠

⁠:ballot_box_with_check: Requirements

• :whale: docker⁠
• :octopus: docker-compose⁠

⁠:fast_forward: Quickstart

If you meet all the requirements, you can use this quickstart script.

It clones the repo, enter in it, runs the setup script, and then opens http://localhost⁠.

$ curl https://raw.githubusercontent.com/verzola/dockerpress/master/bin/quickstart | bash

⁠:scroll: Setup

# clone repo
$ git clone https://github.com/verzola/dockerpress.git

# enter in directory
$ cd dockerpress

# run setup script
$ ./bin/setup

Wait a few seconds and open http://localhost to setup Wordpress.
Open http://localhost

# after initial setup, run this command to start the containers
$ ./bin/start

⁠:deciduous_tree: Environment variables

If you need to edit the default config, edit .env file.

WP_DB_HOST=mysql
WP_DB_NAME=dockerpress
WP_TABLE_PREFIX=wp_
WP_DB_USER=root
WP_DB_PASSWORD=changeme
WP_AUTH_KEY=dev
WP_SECURE_AUTH_KEY=dev
WP_LOGGED_IN_KEY=dev
WP_NONCE_KEY=dev
WP_AUTH_SALT=dev
WP_SECURE_AUTH_SALT=dev
WP_LOGGED_IN_SALT=dev
WP_NONCE_SALT=dev
WP_DEBUG=1

NGINX_VERSION=1.17-alpine

MYSQL_VERSION=8.0
MYSQL_ROOT_PASSWORD=changeme
MYSQL_USER=root
MYSQL_PASSWORD=changeme
MYSQL_DATABASE=dockerpress

⁠:robot: Helpers

These helpers run things inside containers, so you don't have to install anything besides Docker on your machine

• ./bin/composer -> wrapper for composer inside docker
• ./bin/dump -> create a database dump in data/dumps/dump.sql
• ./bin/logs -> show services logs
• ./bin/mailhog -> start mailhog service
• ./bin/mysql -> wrapper for mysql inside docker
• ./bin/reset -> delete everything and start again
• ./bin/setup -> setup dockerpress and starts up containers
• ./bin/start -> start containers
• ./bin/stop-> start up
• ./bin/wp -> wrapper for wp-cli

⁠:electric_plug: Plugins

Plugins can be added on composer.json. Use WPackagist⁠

⁠:mailbox: Mailhog

1. Run ./bin/mailhog
2. Send an e-mail
3. Access http://localhost:8025⁠

⁠:raising_hand_woman: Contributing

Contribuitions are welcome. If you find any problem or have a suggestion, please open an issue⁠

⁠:memo: TODO