Using the All-In-One docker image

Table of contents

All-In-One

The zonemaster-all-in-one docker image provides an All-In-One solution containing Zonemaster-CLI, Zonemaster-Backend, and Zonemaster-GUI.

The zonemaster-all-in-one image can be run from any computer that has Docker installed.

Using Docker

To run Zonemaster via the All-In-One Docker image you have to make sure that Docker is installed and running.

  • Instructions for installation are found on Docker Get started page.
  • Run the command docker ps on the command line to verify that you can run Docker on the computer.

When Docker has been correctly installed, no more installation is needed to run zonemaster-cli. Just follow the examples below.

Out of the box, Docker Desktop does not have official support for IPv6 on neither Windows nor MacOS. While it appears possible to enable it, to the best of our knowledge there is no official documentation for that. If you have not enabled IPv6 we suggest that you run zonemaster-cli with --no-ipv6 and in GUI select IPv4 only before starting a test to avoid meaningless errors. Also see "Using the CLI" for how IPv6 can be enabled under Linux.

Using the All-In-One image

Start the All-In-One container with this command:

docker run --rm -d --name zm-aio -p 8080:80 zonemaster/all-in-one gui

The Zonemaster GUI is now accessible via your browser at http://localhost:8080/.

To stop the container:

docker stop zm-aio

Invoking the command line tool using AIO image

The Zonemaster-CLI tool zonemaster-cli can also be invoked from the zonemaster-all-in-one image by adding the cli argument.

Moreover, there are two more usable Docker images to run zonemaster-cli: zonemaster/cli and zonemaster/backend. For more information on how to use the zonemaster/backend image to invoke Zonemaster-CLI, see the Docker Zonemaster-Backend documentation.

docker run -t --rm zonemaster/all-in-one cli zonemaster.net --no-ipv6

or

docker run -t --rm zonemaster/all-in-one cli zonemaster.net

To make sure that Docker uses the latest version, add --pull always, e.g.

docker run -t --rm --pull always zonemaster/all-in-one zonemaster.net --no-ipv6

If --pull always is skipped, the invocation is quicker. The recommendation is to include --pull always in the first command of a session to make sure that the latest version is used, and then to exclude it to improve performance.

Docker tips

If you run Docker on Mac computer with the M1 chip see "Using the CLI" for more information.