This guide uses Docker Compose to run Netdata for real-time monitoring.
For Docker installation, see Docker.
mkdir -p /opt/netdata/{config,lib,var}
cd /opt/netdata
Create docker-compose.yml:
services:
netdata:
image: netdata/netdata:v2.9.0
container_name: netdata
hostname: docker-host
ports:
- "19999:19999"
volumes:
- ./config:/etc/netdata:rw
- ./lib:/var/lib/netdata:rw
- ./var:/var/cache/netdata:rw
- /etc/passwd:/host/etc/passwd:ro
- /etc/group:/host/etc/group:ro
- /proc:/host/proc:ro
- /sys:/host/sys:ro
- /etc/os-release:/host/etc/os-release:ro
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
- NETDATA_CLAIM_TOKEN=
- NETDATA_CLAM_URL=https://app.netdata.cloud
cap_add:
- SYS_PTRACE
- SYS_ADMIN
security_opt:
- apparmor:unconfined
restart: unless-stopped
docker compose up -d
Check container status:
docker compose ps
View logs:
docker compose logs -f netdata
Access web UI at http://SERVER_IP:19999
docker compose exec netdata vi /etc/netdata/netdata.conf
docker compose restart netdata
docker compose down
docker compose pull
docker compose up -d
curl http://localhost:19999/api/v1/info
NETDATA_CLAIM_TOKEN to connect to cloud./config directoryTo connect to Netdata Cloud, get your claim token from app.netdata.cloud and add:
environment:
- NETDATA_CLAIM_TOKEN=your-claim-token-here
- NETDATA_CLAIM_URL=https://app.netdata.cloud
- NETDATA_CLAIM_ROOMS=your-room-id
Running containers in production? We help with:
Need help? office@linux-server-admin.com or Contact Us