Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Clear Linux* OS wordpress container image

What is this image?

clearlinux/wordpress is a Docker image with wordpress running on top of the official clearlinux base image.

wordpress is a free and open source blogging tool and a content management system (CMS) based on PHP and MySQL, which runs on a web hosting service.

For other Clear Linux* OS based container images, see:

Why use a clearlinux based image?

Clear Linux* OS is an open source, rolling release Linux distribution optimized for performance and security, from the Cloud to the Edge, designed for customization, and manageability.

Clear Linux* OS based container images use:

  • Optimized libraries that are compiled with latest compiler versions and flags.
  • Software packages that follow upstream source closely and update frequently.
  • An aggressive security model and best practices for CVE patching.
  • A multi-staged build approach to keep a reduced container image size.
  • The same container syntax as the official images to make getting started easy.

To learn more about Clear Linux* OS, visit:


Deploy with Docker

The easiest way to get started with this image is by simply pulling it from Docker Hub.

*Note: This container is compatible with the official wordpress image (fpm tag). It usually works together with containers mysql(mariadb) and nginx.

  1. Pull the image from Docker Hub:

    docker pull clearlinux/wordpress
  2. Start wordpress using the examples below:

    • Use docker-compose to start the wordpress/nginx/mariadb in one-shot:

      docker-compose up

      The configuration is defined in the docker-compose.yml

    • List wordpress containers info:

      docker container ls
      CONTAINER ID     IMAGE                       PORTS                  NAMES
      eff987d8f6e9     clearlinux/nginx:latest>80/tcp   wordpress_nginx_1
      738f71a6e7fa     clearlinux/wordpress:latest 9000/tcp               wordpress_wordpress_1
      deaa8614ce8d     clearlinux/mariadb:latest   3306/tcp               wordpress_db_1
  3. Edit web/blog in wordpress: Open one brower to connect the wordpress blog with URL below.


Deploy with Kubernetes

This image can also be deployed on a Kubernetes cluster, such as minikube.The following example YAML files are provided in the repository as reference for Kubernetes deployment:

The example utilies nginx, mariadb and wordpress containers. All are Clear Linux published ones on official clearlinux base image. To deploy the image on a Kubernetes cluster you have two volumes configuration choices:

  • Use local volume, not appropriate for scaling on multi-node cluster.
    kubectl apply -f pv-local.yaml
    kubectl apply -f pvc-local.yaml
  • Use nfs volume, capable for scaling on multi-node cluster.
    kubectl apply -f rbac.yaml
    kubectl apply -f nfs-deployment.yaml
    kubectl apply -f pvc-nfs.yaml

Once the persistent volumes got created, you can continue the wordpress deployment.

  1. Create secret password for database.

    kubectl apply -f secret.yaml
  2. Deploy database and wordpress.

    kubectl apply -f mysql-deployment.yaml
    kubectl apply -f wordpress-deployment.yaml
  3. Then check if the pods are running well.

    kubectl get pods -o wide
  4. Get wordpress PORT and IP

    kubectl get -o jsonpath="{.spec.ports[0].nodePort}" services wordpress
    kubectl get nodes -o jsonpath="{.items[0].status.addresses[0].address}"
  5. Edit web/blog in wordpress: Open one brower to connect the wordpress blog with PORT and IP got on step 2.


If using nfs volumes, you can scale the wordpress depolyment.

kubectl scale deployments/wordpress --replicas=4

There are two scripts for deploy/clean the wordpress in one-shot command.

./          # deploy the wordpress
./ down     # destroy and clean the wordpress
./          # deploy the wordpress
./ down     # destroy and clean the wordpress

Build and modify:

The Dockerfiles for all Clear Linux* OS based container images are available at These can be used to build and modify the container images.

  1. Clone the clearlinux/dockerfiles repository.

    git clone
  2. Change to the directory of the application:

    cd wordpress/
  3. Build the container image:

    docker build -t clearlinux/wordpress .

    Refer to the Docker documentation for default build arguments. Additionally:

    • swupd_args - specifies arguments to pass to the Clear Linux* OS software manager. See the swupd man pages for more information.


All licenses for the Clear Linux* Project and distributed software can be found at

You can’t perform that action at this time.