Scroll to navigation

DOCKER-COMPOSE-EVENTS(1) DOCKER-COMPOSE-EVENTS(1)

NAME

docker-compose-events - Receive real time events from containers

SYNOPSIS

docker compose events [OPTIONS] [SERVICE...]

DESCRIPTION

Stream container events for every container in the project.

With the --json flag, a json object is printed one per line with the format:

{

"time": "2015-11-20T18:01:03.615550",
"type": "container",
"action": "create",
"id": "213cf7...5fc39a",
"service": "web",
"attributes": {
"name": "application_web_1",
"image": "alpine:edge"
} }

The events that can be received using this can be seen here ⟨/reference/cli/docker/system/events/#object-types⟩.

OPTIONS

-h, --help[=false] help for events

--json[=false] Output events as a stream of json objects

OPTIONS INHERITED FROM PARENT COMMANDS

--dry-run[=false] Execute command in dry run mode

SEE ALSO

docker-compose(1)

Mar 2025