Quickstart

This page will show you how to quickly deploy the Fleet Management integration, and connect a Teltonika device to it, as a way to showcase the functions of the installation.

Prerequisites

1. A computer that is publically accessible through an FQDN. Of course, can be an EC2 instance, etc. with either an x86 or ARM64 processor. The following instructions will use a headless Ubuntu hostname.
2. A Docker installation
3. A Teltonika Telematics device (in this guide, we assume that there is no need for the Teltonika legacy server).
4. A method of configuring the device, whether that is through SMS, TCT, or Teltonika Configurator. For simplicity, we are going to use the most recent (at the time of writing) Teltonika Configurator for this tutorial
5. A SIM card

Process

1. Create an empty folder, where we will keep all fleet-management related files

mkdir fleet-management && \
cd fleet-management

2. Download docker-compose.yml

wget https://github.com/openremote/fleet-management/blob/main/docker-compose.yml

3. Start the docker-compose project, with the correct hostname passed as environment variable OR_HOSTNAME:

OR_HOSTNAME={hostname} docker-compose -p fleet-management up -d

4. When all Docker containers are healthy (except for fleet-management-deployment-1), pull the certificate file:

docker cp fleet-management-manager-1:/deployment/letsencrypt/live/{hostname}/fullchain.pem .

5. Reverse the order of the certificate chain:

awk '/-----BEGIN CERTIFICATE-----/{x="cert"++i".pem"}; {print > x}' fullchain.pem && \
(cat cert3.pem; cat cert2.pem; cat cert1.pem) > reversed_certchain.pem && \
rm cert1.pem cert2.pem cert3.pem

Teltonika Configurator

6. Security -> Certificates -> Upload -> select the file reversed_certchain.pem
7. System -> Codec JSON
8. GPRS -> Ensure correct APN settings, follow ISP's instructions
9. GPRS -> Server Settings -> Domain: {hostname}
10. GPRS -> Server Settings -> Port: 8883
11. GPRS -> Server Settings -> TLS Encryption -> TLS/DTLS
12. GPRS -> MQTT Settings -> MQTT Client Type -> Custom
13. GPRS -> MQTT Settings -> Device ID {leave empty}
14. GPRS -> MQTT Settings -> Data Topic -> {realm Name}/{random client ID}/teltonika/%imei%/data
15. GPRS -> MQTT Settings -> Commands Topic -> {realm Name}/{random client ID}/teltonika/%imei%/commands