Forrest logo
back to the docker tool

docker:tldr:9d2eb

docker: Remove unused data created more than a specified amount of time in the past.
$ docker system prune --filter="until=${hours}h${minutes}m"
try on your machine

The command docker system prune --filter="until=${hours}h${minutes}m" is used to remove unused Docker resources based on a filter condition expressed in time.

Let's break down the command:

  • docker system prune: It is a Docker command that removes unused resources, such as dangling images, stopped containers, unused networks, etc., to free up disk space and improve performance. It helps to keep the Docker environment clean and efficient.

  • --filter="until=${hours}h${minutes}m": It is an optional parameter that specifies a filter condition based on time. Here, the filter is applied to determine which resources should be pruned based on their creation time.

The "until=${hours}h${minutes}m" part is a filter expression using time units. It checks for resources that were created until a specific duration of time.

  • ${hours}: It represents the number of hours you want to subtract from the current time. For example, if ${hours} is 1, it will consider resources created within the last hour.

  • ${minutes}: It represents the number of minutes you want to subtract from the current time. For example, if ${minutes} is 30, it will consider resources created within the last 30 minutes.

Together, the --filter="until=${hours}h${minutes}m" option with the docker system prune command filters out unused resources that were created within the specified time period. Any Docker resource that matches the filter condition will be removed during the prune operation. This helps in cleaning up unused resources, especially those that are relatively recent and haven't been used for a given time period.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the docker tool