From 92645e93c8d59c37e2d91395d214961e707051d3 Mon Sep 17 00:00:00 2001 From: Mike Dillon Date: Thu, 5 Feb 2015 20:17:32 -0800 Subject: [PATCH 1/2] Add documentation for `WORDPRESS_DB_HOST` --- wordpress/README.md | 16 +++++++++++----- wordpress/content.md | 16 +++++++++++----- 2 files changed, 22 insertions(+), 10 deletions(-) diff --git a/wordpress/README.md b/wordpress/README.md index 3f3689637866..14a4ee7b1fdd 100644 --- a/wordpress/README.md +++ b/wordpress/README.md @@ -29,15 +29,16 @@ Indonesia. 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_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_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) -If the `WORDPRESS_DB_NAME` specified does not already exist in the given MySQL -container, it will be created automatically upon container startup, provided -that the `WORDPRESS_DB_USER` specified has the necessary permissions to create -it. +If the `WORDPRESS_DB_NAME` specified does not already exist on the given MySQL +server, it will be created automatically upon startup of the `wordpress` +container, provided that the `WORDPRESS_DB_USER` specified has the necessary +permissions to create it. If you'd like to be able to access the instance from the host without the container's IP, standard port mappings can be used: @@ -47,6 +48,11 @@ container's IP, standard port mappings can be used: Then, access it via `http://localhost:8080` or `http://host-ip:8080` in a browser. +If you'd like to use an external database instead of a linked `mysql` container, +specify the hostname and port with `WORDPRESS_DB_HOST`: + + docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 -d wordpress + # Supported Docker versions This image is officially supported on Docker version 1.4.1. diff --git a/wordpress/content.md b/wordpress/content.md index 7b2a06738cf2..61aa7057f405 100644 --- a/wordpress/content.md +++ b/wordpress/content.md @@ -19,15 +19,16 @@ Indonesia. 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_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_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) -If the `WORDPRESS_DB_NAME` specified does not already exist in the given MySQL -container, it will be created automatically upon container startup, provided -that the `WORDPRESS_DB_USER` specified has the necessary permissions to create -it. +If the `WORDPRESS_DB_NAME` specified does not already exist on the given MySQL +server, it will be created automatically upon startup of the `wordpress` +container, provided that the `WORDPRESS_DB_USER` specified has the necessary +permissions to create it. If you'd like to be able to access the instance from the host without the container's IP, standard port mappings can be used: @@ -36,3 +37,8 @@ container's IP, standard port mappings can be used: Then, access it via `http://localhost:8080` or `http://host-ip:8080` in a browser. + +If you'd like to use an external database instead of a linked `mysql` container, +specify the hostname and port with `WORDPRESS_DB_HOST`: + + docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 -d wordpress From f85159efac8375758e8573897f59d6ae14749a4d Mon Sep 17 00:00:00 2001 From: Mike Dillon Date: Fri, 6 Feb 2015 09:44:23 -0800 Subject: [PATCH 2/2] [wordpress] Document need for username/password with external db --- wordpress/README.md | 7 +++++-- wordpress/content.md | 7 +++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/wordpress/README.md b/wordpress/README.md index 14a4ee7b1fdd..7b1c66964019 100644 --- a/wordpress/README.md +++ b/wordpress/README.md @@ -49,9 +49,12 @@ Then, access it via `http://localhost:8080` or `http://host-ip:8080` in a browser. If you'd like to use an external database instead of a linked `mysql` container, -specify the hostname and port with `WORDPRESS_DB_HOST`: +specify the hostname and port with `WORDPRESS_DB_HOST` along with the password +in `WORDPRESS_DB_PASSWORD` and the username in `WORDPRESS_DB_USER` (if it is +something other than `root`): - docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 -d wordpress + docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 \ + -e WORDPRESS_DB_USER=... -e WORDPRESS_DB_PASSWORD=... -d wordpress # Supported Docker versions diff --git a/wordpress/content.md b/wordpress/content.md index 61aa7057f405..d73505d54fbd 100644 --- a/wordpress/content.md +++ b/wordpress/content.md @@ -39,6 +39,9 @@ Then, access it via `http://localhost:8080` or `http://host-ip:8080` in a browser. If you'd like to use an external database instead of a linked `mysql` container, -specify the hostname and port with `WORDPRESS_DB_HOST`: +specify the hostname and port with `WORDPRESS_DB_HOST` along with the password +in `WORDPRESS_DB_PASSWORD` and the username in `WORDPRESS_DB_USER` (if it is +something other than `root`): - docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 -d wordpress + docker run --name some-wordpress -e WORDPRESS_DB_HOST=10.1.2.3:3306 \ + -e WORDPRESS_DB_USER=... -e WORDPRESS_DB_PASSWORD=... -d wordpress