Install BDOT Collector in Docker Compose
Installing a BDOT Collector in Docker Compose has a different flow compared to collectors for Linux, Mac, and Windows.
Install a BDOT Collector
-
Navigate to the Agents page and select Install Agent
-
Choose the Linux Platform
-
Copy the
secret-key
andopamp-endpoint
-
Create a
docker-compose.yaml
and paste this content below -
Create two directories and two files for
storage
andconfig
. -
Paste this into your
config.yaml
file in thestorage
directory.note
This is just the initial config, and should not be manually edited. Bindplane will push edits to this file remotely via the roll out feature.
-
Paste this into your
logging.yaml
file in the storage directory: -
The
manager.yaml
that will be auto-updated when creating rolling out a config from Bindplane. -
Start the BDOT Collector:
Create a configuration for Docker Compose
- Navigate to the Configurations and select Create Configuration
- Select the Linux Platform and give it a name
- Add sources and destinations and create the configuration
- Click Add Agents, select the BDOT Collector you created above, and click Apply
- Finally, click Start Rollout, and you're done!
Example Installation
This example uses the Host metrics, OTLP logs and metrics, and file logs.

Get the BDOT Collector secret key, installation id, and OpAMP configuration keys from the Collector installation page.

Ensure that the OPAMP_ENDPOINT
environment variable has the correct value for your server.
The port should be 3001
for non-TLS, and 443
if TLS is enabled. Similarly, the protocol should be ws
(websocket) when TLS is not configured, and wss
(secure web socket) when TLS is enabled.
Start Docker Compose with docker compose up -d
. Once deployed, your collector will appear on the Agents page, and they will be bound to your configuration.

TLS
BDOT Collectors in Docker Compose can be configured to connect to Bindplane using TLS. If the Bindplane TLS certificate is publicly signed, no action is required. If the certificate is signed by an internal certificate authority, the collector can be configured with a custom certificate authority for verifying the Bindplane certificate.
Your certificate authority file (ca.crt) can be added to a BDOT Collector docker-compose.yaml
with the OPAMP_TLS_CA
environment variable. The sample below considers you storing the ca.crt
in a certs
directory and binding the volume to the bdot-collector
.
Using this example, the CA certificate ca.crt will be mounted to /opt/tls/ca.crt. The OpAMP client will be configured to use this certificate authority when validating CA certificates.
Mutual TLS (mTLS)
When using mutual TLS, the same process is used. In this case, a client keypair is provided. This example uses client.crt
and client.key
.
With these secrets you can modify your BDOT Collector Docker Compose service and add environment variables for the TLS certs and keys.