---
name: "docker-compose-events"
section: "1"
platform: "linux"
package: "docker-compose"
version: "2.26.1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/docker-compose-events"
---

# docker-compose-events(1)

Receive real time events from containers

## 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)](/docker-compose/1.md)**