Skip to content

Docker and Docker Compose

Dave Walker edited this page Jul 10, 2026 · 1 revision

Overview

The Relaxed Clock Explorer and Strict Clock Explorer are available as Docker container images. Please see the following Docker Hub repositories for more information:

Running the Explorers Using the Docker Command Line

Strict Clock Explorer

To run the Strict Clock Explorer using the docker command line, use the following:

docker run -d -p 8101:8501 --platform linux/amd64 --name strictclock --rm davewalker5/strictclockexplorer:latest

Make sure the port number, 8101 in this example, is an unused port on the local machine. Once the container is running, browsing to the following URL should show the explorer page:

http://localhost:8101

Replace the port number, 8101, with the port used in the docker run command. To stop the application, run the following command:

docker stop strictclock

Relaxed Clock Explorer

To run the Relaxed Clock Explorer using the docker command line, use the following:

docker run -d -p 8096:8501 --platform linux/amd64 --name relaxedclock --rm davewalker5/relaxedclockexplorer:latest

Make sure the port number, 8096 in this example, is an unused port on the local machine. Once the container is running, browsing to the following URL should show the explorer page:

http://localhost:8096

Replace the port number, 8096, with the port used in the docker run command. To stop the application, run the following command:

docker stop relaxedclock

Running the Explorers Using Docker Compose

Strict Clock Explorer

The following is an example Docker Compose file that can be used to run the Strict Clock Explorer from the published Docker image. It should be saved as docker-compose.yml to an appropriate folder.

services:
  strictclockexplorer:
    container_name: strictclockexplorer
    image: davewalker5/strictclockexplorer:latest
    platform: linux/amd64
    restart: always
    ports:
      - "8101:8501"

Make sure the port number, 8101 in this example, is an unused port on the local machine.

To start the application, open a terminal window, change to the folder containing docker-compose.yml and run the following command:

docker compose --project-directory . up -d

The output should look similar to this:

[+] up 2/2
 ✔ Network strictclockexplorer_default Created                                0.0s
 ✔ Container strictclockexplorer       Started                                0.1s

With the application running, browsing to the following URL should show the explorer page:

http://localhost:8101

Replace the port number, 8101, with the port used in the Docker Compose file.

To stop the application, from the same folder run the following command:

docker compose --project-directory . down
  • The output should look similar to this:
[+] down 2/2
 ✔ Container strictclockexplorer       Removed                                10.2s
 ✔ Network strictclockexplorer_default Removed                                0.2s

Relaxed Clock Explorer

The following is an example Docker Compose file that can be used to run the Relaxed Clock Explorer from the published Docker image. It should be saved as docker-compose.yml to an appropriate folder.

services:
  relaxedclockexplorer:
    container_name: relaxedclockexplorer
    image: davewalker5/relaxedclockexplorer:latest
    platform: linux/amd64
    restart: always
    ports:
      - "8096:8501"

Make sure the port number, 8096 in this example, is an unused port on the local machine.

To start the application, open a terminal window, change to the folder containing docker-compose.yml and run the following command:

docker compose --project-directory . up -d

The output should look similar to this:

[+] up 2/2
 ✔ Network relaxedclockexplorer_default Created                               0.0s
 ✔ Container relaxedclockexplorer       Started                               0.1s

With the application running, browsing to the following URL should show the explorer page:

http://localhost:8096

Replace the port number, 8096, with the port used in the Docker Compose file.

To stop the application, from the same folder run the following command:

docker compose --project-directory . down
  • The output should look similar to this:
[+] down 2/2
 ✔ Container relaxedclockexplorer       Removed                               10.2s
 ✔ Network relaxedclockexplorer_default Removed                               0.2s

Clone this wiki locally