---
title: Linux Worker Deployment
slug: telemetry-pipeline/linux-worker-deployment
docTags: 
createdAt: 2026-01-06T07:50:07.278Z
---

### 1. Worker Installation

**1.1 Docker Installation**

Install Docker following the same steps described in **Section 1.1**.

**1.2 Configuration Files**

Copy the following files to the worker server:

- configs/&#x20;
- common-encrypt&#x20;
- worker.yml&#x20;

**1.3 Credential Encryption**

To connect the worker to GitLab or GitHub, credentials must be stored **encrypted**.

Use common-encrypt to generate encrypted versions of:

- Username&#x20;
- Password / Token&#x20;

**1.4 Worker Registration**

- Create a new worker via the CMS UI&#x20;
- Copy the generated **Worker ID**&#x20;
- Update configs/config.json:&#x20;
  - Insert encrypted username and password&#x20;
  - Insert plain username and token&#x20;
  - Append the Worker ID to repoUrl after worker-config/&#x20;

**1.5 Start Worker**

:::BlockQuote
docker compose -f worker.yml -p dsp up -d
:::

Verify:

- No errors in container logs&#x20;
- Assigned pipeline is present at:&#x20;

:::BlockQuote
/app/repo/\<WORKER\_ID>/pipeline
:::

**1.6 Pipeline Verification**

If the directory is empty, verify the pipeline exists in GitLab:

:::BlockQuote
/product/dsp/worker-config/\<WORKER\_ID>/pipeline
:::

