Ignition on Docker - Community Image

This is the Git repository for the Unofficial/Community Ignition Docker image. It includes a docker-bake.hcl in addition to the Dockerfile entries to allow for easy image building. See the Docker Hub page for the full README on how to utilize this Docker image and for information regarding contributing and registering issues.

The full README documentation from the Docker Hub page is maintained in the docs folder in the event that you find typos or areas that need more detail or content.

NOTE: Inductive Automation maintains the official Ignition image on Docker Hub for the 8.1+ series of releases. Check out that page if you're interested in running your containers in production. This is also where to go for nightly images, too!

Building the Image

When updated, this image is pushed to Docker Hub via GH actions. To customize and build your own version of the image, use the instructions in this section.

Available Build Targets

The image build leverages docker buildx bake to provide targets for each of the available permutations of the image.

By default, the BASE_IMAGE_NAME variable refers to localhost:5000/kcollins/ignition. You can override the base image name by setting this environment variable prior to running the various docker buildx bake commands in the next sections.

Single Architecture Local Builds

If you want to build an image for your local Docker installation (without a registry), you can build a target with the following:

docker buildx bake --load --set \*.platform=linux/arm64 8_1-full

Note that you must specify a platform in this mode (linux/amd64, linux/arm64, or linux/arm) since manifests are not supported with exporting directly to Docker Engine.

Multi Architecture Builds

If you want to build a multi-platform image+manifest, you must have a registry to target. You can build a target with the following:

docker buildx bake --push 8_1-full