Install the Collector with Docker

You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.

The following commands pull a Docker image and run the Collector in a container. Replace 0.128.0 with the version of the Collector you want to run.

docker pull otel/opentelemetry-collector:0.128.0
docker run otel/opentelemetry-collector:0.128.0
docker pull ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector:0.128.0
docker run ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector:0.128.0

To load a custom configuration file from your working directory, mount the file as a volume:

docker run -v $(pwd)/config.yaml:/etc/otelcol/config.yaml otel/opentelemetry-collector:0.128.0
docker run -v $(pwd)/config.yaml:/etc/otelcol/config.yaml ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector:0.128.0

Docker Compose

You can also add the OpenTelemetry Collector to your existing docker-compose.yaml file:

otel-collector:
  image: otel/opentelemetry-collector
  volumes:
    - ./otel-collector-config.yaml:/etc/otelcol/config.yaml
  ports:
    - 1888:1888 # pprof extension
    - 8888:8888 # Prometheus metrics exposed by the Collector
    - 8889:8889 # Prometheus exporter metrics
    - 13133:13133 # health_check extension
    - 4317:4317 # OTLP gRPC receiver
    - 4318:4318 # OTLP http receiver
    - 55679:55679 # zpages extension