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
- Visit https://portal.causely.app and log in.
- Click on the gear icon in the top-right corner and select
Integrations - Click the
Details 🗝️button and copy your access token to use in the next step.
Step 2: Download the Docker bundle via install.sh
Replace <org>, <repo>, and <tag> with your GitHub org/repo and release tag (or main):
curl -fsSL https://raw.githubusercontent.com/Causely/causely-docker/main/install.sh | bash
This script creates a causely-docker/ directory, downloads docker-compose.yaml, config files under configs/, and an environment file at env/.env.
Step 3: Edit environment variables
Set the following environment variables in your .env file:
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
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 Diagnose and Prevent menus.
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.