Skip to content

remove support for AutoRemove (--rm) on API < 1.30 - #6525

Merged
thaJeztah merged 1 commit into
docker:masterfrom
thaJeztah:rm_client_side_autorm
Oct 3, 2025
Merged

remove support for AutoRemove (--rm) on API < 1.30#6525
thaJeztah merged 1 commit into
docker:masterfrom
thaJeztah:rm_client_side_autorm

Conversation

@thaJeztah

@thaJeztahthaJeztah commented Sep 30, 2025

Copy link
Copy Markdown
Member

relates to:

remove support for AutoRemove (--rm) on API < 1.30

Support for daemon-side auto-remove was added in API v1.25; on older versions of the daemon, the client was responsible for removing the container after it exited (see moby@6dd8e10)

On API versions < 1.30, it used the events API for this purpose, and would wait for a "die", "detach" or "detroy" events to know the container exited, and could be removed or (when attached, but without a TTY) to get the container's exit-status. (see cli@38591f2).

API version 1.24 (docker 1.12) is 9 Years old (July 29, 2016), and API 1.30 (docker 17.06) is 8 Years old (Jun 20, 2017), and long EOL. While technically, a CLI could negotiate API 1.30 or older, this would only be in cases where either API version negotiation failed, or the version was explicitly overridden through DOCKER_API_VERSION for testing.

Either of those cases would be rare, and not worth the technical complexity to support. This patch removes support for AutoRemove on API < 1.30.

- What I did

- How I did it

- How to verify it

- Human readable description for the release notes

Remove support for AutoRemove (`--rm`) on API < 1.30

- A picture of a cute animal (not mandatory but encouraged)

Support for daemon-side auto-remove was added in API v1.25; on older
versions of the daemon, the client was responsible for removing the
container after it exited (see [moby@6dd8e10])
On API versions < 1.30, it used the events API for this purpose, and
would wait for a "die", "detach" or "detroy" events to know the container
exited, and could be removed or (when attached, but without a TTY) to
get the container's exit-status. (see [cli@38591f2]).
API version 1.24 (docker 1.12) is 9 Years old (July 29, 2016), and API
1.30 (docker 17.06) is 8 Years old (Jun 20, 2017), and long EOL. While
technically, a CLI could negotiate API 1.30 or older, this would only
be in cases where either API version negotiation failed, or the version
was explicitly overridden through `DOCKER_API_VERSION` for testing.
Either of those cases would be rare, and not worth the technical complexity
to support. This patch removes support for AutoRemove on API < 1.30.
[moby@6dd8e10]: moby/moby@6dd8e10
[cli@38591f2]: docker@38591f2
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
@thaJeztahthaJeztah added this to the 29.0.0 milestone Sep 30, 2025
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@thaJeztah
thaJeztah merged commit ca6f899 into docker:masterOct 3, 2025
98 checks passed
@thaJeztah
thaJeztah deleted the rm_client_side_autorm branch October 3, 2025 09:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@thaJeztah@codecov-commenter@vvoland