Skip to content

Alemca Agent Configuration

The agent is configured through a YAML file.
This file contains every setting required for the agent to operate correctly, including which modules to load, connection parameters, and other module-specific options.

Automatic Agent Configuration

To auto-configure the Alemca Agent, start it with the --name (or --serial-number) flag.
The value must match the device name registered in the Alemca console.

Prerequisites

  • Enable Pairing mode on the Alemca Platform before running the command.
  • To enable Remote Advanced connectivity:
  • Open the device’s Security tab.
  • Click Add ACL.
  • Select Remote Advanced.

Command example

agent-alemca --name 1234567890 --config /etc/alemca/config.yaml

Running this command will:

  • Generate a new token for the device.
  • Create (or update) the configuration file and place it at /etc/alemca/config.yaml.

When the agent is installed via the Teltonika package, the device name is fetched automatically and the configuration file is created in /etc/alemca/config.yaml.

Manual Agent Configuration

You can also configure the Alemca Agent manually by editing a YAML file.

  1. A template file is shipped at /etc/alemca/config.yaml.template. It contains a working configuration you can adapt.
  2. Edit the template, save it under a new name, and point the agent to it at startup with --config:
agent-alemca --config /etc/alemca/config.yaml

Every module and component of the agent is configured directly inside this file.

Minimal configuration required example

Below is a minimal YAML configuration for the Alemca Agent.

/etc/alemca/config.yaml
global:
  client_root: "client_root_example"
  ident: "client_id_example"
  token: "client_token_example"
  cache_path: "/tmp/cache"

Advanced configuration

For advanced topics, refer to: