Skip to main content

Standalone Docker Host Installation

This installation method extends Causely beyond Kubernetes clusters to standalone Docker hosts, enabling telemetry collection and root‑cause analysis for services running outside Kubernetes.

Prerequisites​

  • Docker Engine installed on the host
  • Linux kernel with eBPF support (5.4+ recommended)
  • Ability to run privileged containers and use pid: host

1. Install the Causely Agent on a Docker Host​

Step 1: Retrieve Your Access Token​

  1. Visit https://portal.causely.app and log in.
  2. Click on the gear icon in the top-right corner and select Integrations
  3. Click the Details 🗝️ button and copy your access token to use in the next step.

Step 2: Download the Docker bundle via install.sh​

curl -fsSL https://raw.githubusercontent.com/causely-oss/causely-deploy/refs/heads/main/docker/install.sh | bash

This script creates a causely-docker/ directory, downloads docker-compose.yaml, config files, and a .env file.

Step 3: Edit environment variables​

Set the following environment variables in your .env file. Note that <my_token> is the token retrieved in step 1 and <my_docker_host_name> is the friendly name you'd like displayed in the Causely UI.

CAUSELY_GATEWAY_TOKEN=<my_token>
DOCKER_HOST_NAME=<my_docker_host_name>

Step 4: Start the stack​

Run the following command to start the Causely stack:

docker compose up -d

Step 5: Review Discovery​

To verify the agent is successfully installed navigate to the Integrations Agents view. Once the agent has appeared you have successfully installed Causely!

Navigate to https://portal.causely.app to verify your environment has been discovered. You should see entities populated in the Topology view. As root causes are identified, they will appear in the Root Cause view.

Next Steps​

Visit the Customize your Installation page to learn more about customizing your installation.

We recommend that you connect additional telemetry sources to help Causely identify root causes in your environment. Visit the Telemetry Sources page to learn more about the data sources that Causely supports.

To push insights into your workflows, visit the Workflow Integrations page.