Merge pull request #152 from md5/wordpress-external-db

Add documentation for WORDPRESS_DB_HOST
This commit is contained in:
Tianon Gravi 2015-02-06 10:55:07 -07:00
commit a3e4b5e8bd
2 changed files with 28 additions and 10 deletions

View File

@ -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,14 @@ 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` 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 \
-e WORDPRESS_DB_USER=... -e WORDPRESS_DB_PASSWORD=... -d wordpress
# Supported Docker versions
This image is officially supported on Docker version 1.4.1.

View File

@ -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,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` 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 \
-e WORDPRESS_DB_USER=... -e WORDPRESS_DB_PASSWORD=... -d wordpress