4.8 KiB

Raw Blame History

Bitnami Docker Image for WordPress

This is an all-in-one container for Bitnami WordPress Stack. It includes all the required dependencies to run WordPress in a container in less than 1 minute.

TLDR

docker run --name=wordpress -p 80:80 -p 443:443 bitnami/wordpress

Get this image

The recommended way to get the Bitnami Docker Image for WordPress is to pull the prebuilt image from the Docker Hub Registry.

docker pull bitnami/wordpress:latest

To use a specific version, you can pull a versioned tag. You can view the list of available versions in the Docker Hub Registry.

docker pull bitnami/wordpress:[TAG]

If you wish, you can also build the image yourself.

git clone https://github.com/bitnami/bitnami-docker-wordpress.git
cd bitnami-docker-wordpress
docker build -t bitnami/wordpress .

Configuration

Application credentials

Running the container in foreground will show some information about to access your application. If you started the container with the flag -d you can retrieve it by running docker logs wordpress.

In case you want to change the default user and password you would need to build the image by your own following this steps and modifying the line BITNAMI_APPLICATION_PASSWORD=bitnami in the Dockerfile before starting the build.

Application files (optional)

If you want to make the application files accessible for modifying them you could use a volume to share these files with the host. This can be done by adding some extra options to the docker run command:

docker run --name=wordpress -v ~/wordpress-files:/opt/bitnami/apps -e USER_UID=`id -u` -p 80:80 -p 443:443 bitnami/wordpress

This will create a folder wordpress-files in your home directory exposing the folder /opt/bitnami/apps in the container. This folder should be empty or non existent when creating the container.

NOTE: Currently is only possible to expose /opt/bitnami/apps. Also setting the variable USER_UID will make the files modifiable by your current user.

Logging

The Bitnami Docker Image for WordPress will write to stdout the information about the initialization process so it is accesible by running the command docker logs wordpress.

In order to check the logs from services as the HTTP server or databases you could use the following commands:

docker exec -it wordpress /opt/bitnami/scripts/logs.sh apache
docker exec -it wordpress /opt/bitnami/scripts/logs.sh mysql

Maintenance

Backing up your container

In order to backup your containers you could pack the /opt/bitnami directory and copy it to the host by running the following commands:

docker exec -it wordpress /opt/bitnami/ctlscript.sh stop
docker exec -it wordpress tar -pczvf /tmp/wordpress-backup.tar.gz /opt/bitnami
docker exec -it wordpress /opt/bitnami/ctlscript.sh start
docker cp wordpress:/tmp/wordpress-backup.tar.gz /path/to/destination/directory

NOTE: this commands assume that your container is named wordpress.

Upgrade this image

This image is intended for development/testing purposes. For this reason, upgrading the individual components is not supported yet.

Testing

This image is tested for expected runtime behavior, using the Bats testing framework. You can run the tests on your machine using the bats command.

bats test.sh

Contributing

We'd love for you to contribute to this container. You can request new features by creating an issue, or submit a pull request with your contribution.

Issues

If you encountered a problem running this container, you can file an issue. For us to provide better support, be sure to include the following information in your issue:

Host OS and version
Docker version (docker version)
Output of docker info
Version of this container (echo $BITNAMI_APP_VERSION inside the container)
The command you used to run the container, and any relevant output you saw (masking any sensitive information)

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

4.8 KiB Raw Blame History