docker ps --filter annotation: 9 Easy Examples and Errors
Docker Engine 29.8.0 added an annotation filter to the container list. Run docker ps --filter annotation=KEY to list containers that carry an annotation key, or docker ps --filter annotation=KEY=VALUE to match the key and the exact value. Older engines (29.7.x and before) store annotations set with docker run --annotation , but answer the same filter with Error response from daemon: invalid filter 'annotation' . Every example below was tested on 2026-10-20 with the official images docker:29.9.1-dind (API 1.56) and docker:29.7.2-dind (API 1.55), each running in a rootless podman container. All output is copied from that lab; nothing is shortened except long container IDs. Contents What changed in Docker 29.8.0 Annotations vs labels docker ps --filter annotation: key and key=value Exact match only: no wildcards, case-sensitive Empty values Combining docker ps --filter annotation with other filters The label filter does not see annotations Use the filter with stop, inspec...