Skip to content

Commit d9f94d5

Browse files
authored
Merge pull request #4618 from thaJeztah/24.0_backport_cli-issue-502
[24.0 backport] Add docker ps status descriptions
2 parents 30a185e + 54d83fb commit d9f94d5

File tree

1 file changed

+13
-3
lines changed
  • docs/reference/commandline

1 file changed

+13
-3
lines changed

docs/reference/commandline/ps.md

+13-3
Original file line numberDiff line numberDiff line change
@@ -174,9 +174,19 @@ Any of these events result in a `137` status:
174174

175175
#### status
176176

177-
The `status` filter matches containers by status. You can filter using
178-
`created`, `restarting`, `running`, `removing`, `paused`, `exited` and `dead`. For example,
179-
to filter for `running` containers:
177+
The `status` filter matches containers by status. The possible values for the container status are:
178+
179+
| Status | Description |
180+
| :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
181+
| `created` | A container that has never been started. |
182+
| `running` | A running container, started by either `docker start` or `docker run`. |
183+
| `paused` | A paused container. See `docker pause`. |
184+
| `restarting` | A container which is starting due to the designated restart policy for that container. |
185+
| `exited` | A container which is no longer running. For example, the process inside the container completed or the container was stopped using the `docker stop` command. |
186+
| `removing` | A container which is in the process of being removed. See `docker rm`. |
187+
| `dead` | A "defunct" container; for example, a container that was only partially removed because resources were kept busy by an external process. `dead` containers cannot be (re)started, only removed. |
188+
189+
For example, to filter for `running` containers:
180190

181191
```console
182192
$ docker ps --filter status=running

0 commit comments

Comments
 (0)