earthly/dind

Manage earthly/dind docker images

Earthly dind (Docker In Docker) Images

Earthly's official earthly/dind docker images. For information on how to use these images, please refer to docker in earthly.

Supported Distributions

There are currently 3 supported dind distributions available:

• alpine
• ubuntu:20.04
• ubuntu:23.04
• ubuntu:24.04

Other distributions and/or base images can be used with our dind+INSTALL FUNCTION.

How Images are Built

In this repository, we maintain the OS & Docker versions that warrants releasing a new version of the image. However, the installations of docker and other dependencies are done via an installation script that is currently maintained in earthly/earthly.

Dependencies

Dependencies are maintained by Renovate and will be merged automatically (provided required checks pass), primarly dependencies that will trigger new versions of the dind images such as the docker or the os (alpine) versions.

Repo structure

.
├── Earthfile // Targets that apply to all images (e.g. +test) 
├── common
│   └── Earthfile // A library of common helper targets
└── os // Each directory contains an Earthfile with targets to maintain the specific os (e.g. +test, +build)
    ├── alpine
    │   └── Earthfile
    ├── ubuntu-20.04
    │   └── Earthfile
    └── ubuntu-23.04
        └── Earthfile
    └── ubuntu-24.04
        └── Earthfile

Testing

Images are tested by running remote test targets that are maintained in earthly/earthly. This is because these tests also help test WITH DOCKER command in earthly cli.

Temporary images are built, pushed, and pulled as part of the test cycle.

How to run tests

• Test a specific image os:

earthly --push -P ./os/<os>+test-build

• Test all images:

earthly --push -P +test

Community members

Community members do not have permissions to push a built image and run the tests against it. However, they can easily set a different dockerhub repository by changing the DOCKERHUB_USER ARG value in .arg to a private repository or by passing the arg in the earthly command, e.g. earthly --push -P +test --DOCKERHUB_USER=<your-user>.

Deployment

When the relevant dependencies are updates by Renovate, new images/tags will be pushed automatically to the docker registry.

Contributing

• Please report bugs as GitHub issues.
• Join us on Slack!
• Questions via GitHub issues are welcome!
• PRs welcome! But please give a heads-up in a GitHub issue before starting work. If there is no GitHub issue for what you want to do, please create one.
• Check the contributing page for more details.

Licensing

Earthly is licensed under the Mozilla Public License Version 2.0. See LICENSE.

dind's Issues

Add slack integration to notify a new release

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update earthly/earthly digest to c70b270
• Update dependency docker/docker to v25.0.5
• Update docs-dind-images
• Update dependency docker/docker to v27.1.0
• Update dependency docker/docker to v26
• Update dependency docker/docker to v27
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

dockerfile

Earthfile

common/Earthfile

os/alpine/Earthfile

os/ubuntu-20.04/Earthfile

os/ubuntu-23.04/Earthfile

os/ubuntu-24.04/Earthfile

github-actions

.github/workflows/ci.yml

• earthly/actions v1
• actions/checkout v4

.github/workflows/release.yml

• earthly/actions v1
• actions/checkout v4

.github/workflows/update_readme.yml

• actions/checkout v4
• peter-evans/dockerhub-description v4.0.0

regex

.github/workflows/ci.yml

• earthly/earthly v0.8.15

.github/workflows/release.yml

• earthly/earthly v0.8.15

os/alpine/Earthfile

• alpine 3.20
• alpine_3_20/docker 26.1.3-r2

os/ubuntu-20.04/Earthfile

• docker/docker 27.1.0

os/ubuntu-23.04/Earthfile

• docker/docker 25.0.2

os/ubuntu-24.04/Earthfile

• docker/docker 27.0.3

os/alpine/Earthfile

• alpine 3.20

.arg

• earthly/earthly main@da0cc0e727e211a9aff130b90f70a242a75a0a88

docs/dockerhub.md

• earthly/dind alpine-3.20-docker-26.1.3-r1
• earthly/dind ubuntu-20.04-docker-27.0.3-1
• earthly/dind ubuntu-23.04-docker-25.0.2-1
• earthly/dind ubuntu-24.04-docker-27.0.3-1

---

• Check this box to trigger a request for Renovate to run again on this repository

Add a renovate validator job

The job should run when a PR is opened to validate the config before merging

Enable autoskip for tests

Right now there is some limitation that does not allow AutoSkip to run(May be an AutoSkip bug)

Create a new tag in github when publishing a new tag to docker

Allow triggering a release manually

The release is currently triggered automatically after a renovate branch is merged.
It would be good to be able to fallback to manual release (that is still executed from a gh workflow) in order to force release upon request.
The manual release should allow the user to choose on which branch/commit to base the release (Default main latest)