Skip to content

Agent Linux Setup Guide

A step-by-step installation guide for the DC CORE Telemetry agent and Runtime environment on Linux.


Part 1: Telemetry Setup

Step 1 — Download the Installer

bash
wget https://cud.dccore.io/dcc_downloader_linux

Step 2 — Make It Executable

bash
chmod +x ./dcc_downloader_linux

Step 3 — Install the Telemetry Agent

bash
sudo ./dcc_downloader_linux --background-task --auto-update dcc-telemetry-linux

Step 4 — Retrieve Your Device ID

bash
cat /var/lib/dccore/device_id

Example output:

21eb8afa681e4e20af5ae319fed6eda6root@srv301712406:~#

⚠️ Note: The device ID appears directly before the command prompt with no line break. In the example above, the Device ID is: 21eb8afa681e4e20af5ae319fed6eda6

Copy only the alphanumeric string — do not include the hostname or prompt characters.

Keep this ID safe — it is required to register your device in the DC CORE dashboard.


Part 2: Runtime Setup

Two Runtime versions are available depending on your environment:

VersionPackage NameUse Case
GUIdcc_runtime_linuxDesktops or servers with a display
Headlessdcc_runtime_linux_headlessServers without a GUI (recommended for most deployments)

Step 1 — Download the Installer

Skip this step if the installer was already downloaded during Part 1 and you are in the same directory.

bash
wget https://cud.dccore.io/dcc_downloader_linux

Step 2 — Make It Executable

bash
chmod +x ./dcc_downloader_linux

Step 3 — Install the Runtime

Headless / Server (recommended):

bash
sudo ./dcc_downloader_linux --background-task --auto-update dcc_runtime_linux_headless

GUI / Desktop:

bash
sudo ./dcc_downloader_linux --background-task --auto-update dcc_runtime_linux

Step 4 — Access the Runtime Interface

Once the Runtime is running, open a browser on any device on the same network and go to:

http://<device-ip>:8444

Replace <device-ip> with the local IP address of your Linux server (e.g. http://192.168.1.50:8444).

From the page you can either:

  • Scan the QR code using a mobile device, or
  • Click the link to open the Central Link Interface

Quick Reference

TaskCommand
Download installerwget https://cud.dccore.io/dcc_downloader_linux
Set permissionschmod +x ./dcc_downloader_linux
Install Telemetrysudo ./dcc_downloader_linux --background-task --auto-update dcc-telemetry-linux
Get Device IDcat /var/lib/dccore/device_id
Install Runtime (headless)sudo ./dcc_downloader_linux --background-task --auto-update dcc_runtime_linux_headless
Install Runtime (GUI)sudo ./dcc_downloader_linux --background-task --auto-update dcc_runtime_linux
Access UIhttp://<device-ip>:8444