Installation on the remote machine using Docker Compose¶

The TeskaLabs LogMan.io Collector can be installed on a remote machine using Docker Compose. The docker-compose.yaml file is typically located in /opt/site-lmio-collector.

Determine the service identifier of the Collector. It is typically composed as lmio-collector-<tenant>-<number>, for example lmio-collector-mytenant-1. Use this value as <service-identifier> in the following steps.

On the host machine, create directories for the Collector configuration and data:

mkdir -p /opt/site-lmio-collector/<service-identifier>/conf
mkdir -p /data/hdd/<service-identifier>/var

Create the Collector configuration files in /opt/site-lmio-collector/<service-identifier>/conf:
/opt/site-lmio-collector/<service-identifier>/conf/lmio-collector.yaml
```
connection:CommLink:commlink:
  url: https://logman.example.com/lmio-receiver
```
Replace https://logman.example.com/lmio-receiver with the URL of your LogMan.io Receiver. Make sure the hostname in the Receiver URL resolves on the Collector machine (DNS or /etc/hosts).
/opt/site-lmio-collector/<service-identifier>/conf/lmio-collector.conf
```
[config]
path=/conf/lmio-collector.yaml

[general]
var_dir=/app/lmio-collector/var
buffer_dir=/app/lmio-collector/var/buffer
```
Log sources are configured later from the LogMan.io Web UI or by extending lmio-collector.yaml. See the Collector reference manual.

Create /opt/site-lmio-collector/docker-compose.yaml:

/opt/site-lmio-collector/docker-compose.yaml

services:
  <service-identifier>:
    image: pcr.teskalabs.com/lmio/lmio-collector:stable
    container_name: <service-identifier>
    volumes:
      - ./<service-identifier>/conf:/conf
      - /data/hdd/<service-identifier>/var:/app/lmio-collector/var
    network_mode: host
    restart: always

Replace <service-identifier> with your Collector service identifier (for example lmio-collector-mytenant-1).

Start the Collector:

docker compose -f /opt/site-lmio-collector/docker-compose.yaml up -d

Verify that the Collector is running and note its identity:
```
docker logs <service-identifier> 2>&1 | grep identity
```
The identity is a 16-character string shown in the log output. You need it for provisioning.
Provision the Collector in the LogMan.io Web UI. Open Log sources >> Collectors, click Provision, and assign the Collector to a tenant.

After provisioning, configure log sources in Log sources >> Collectors as described in the Collector administration manual.