dimahkiin/egts_gateway repository overview

⁠dimahkiin/egts_gateway

egts_gateway is a TCP server for the EGTS (Era Glonass Telematics Standard) protocol. It accepts connections from telematics terminals, decodes EGTS packets and delivers them to one or more destinations: stdout, rotating NDJSON files, other EGTS servers, RabbitMQ queues and Valkey/Redis Streams. Incoming authentication is optional, delivery is buffered in an in-memory queue, and undelivered packets are dumped to disk on shutdown and restored on the next start.

Sources: github.com/LdDl/go-egts⁠

⁠Configuration

The image ships no configuration file. There are two mutually exclusive ways to configure it, and exactly one CLI flag: -conf.

• TOML - pass -conf <path> after the image name and bind-mount the file. Environment variables and .env are then ignored.
• Environment - without -conf, the gateway reads EGTS_* variables. If /app/.env exists (the working directory is /app), its values override the process environment.

Without either, the built-in defaults apply: listen on 0.0.0.0:8081, no authentication, packets to stdout, application logs to stderr.

Minimal working TOML:

[server_cfg]
host = "0.0.0.0"
port = 8081

[destinations_cfg]
stdout = true

Unset keys fall back to the defaults, but unknown keys are rejected at startup. The full annotated example is egts_gateway.toml⁠; the full variable list is .env.example⁠.

Non-obvious startup conditions:

• Listen on 0.0.0.0 inside the container. 127.0.0.1 in server_cfg.host / EGTS_SERVER_HOST makes the published port unreachable.
• At least one packet destination must be enabled, otherwise the process exits with an error.
• Application logs and packets may not share an output: logs_cfg.output = "stdout" together with destinations_cfg.stdout = true is rejected, as are overlapping log, packet and dump directories.
• Relative paths such as ./data/queue resolve against the working directory /app, so mount a volume at /app/data to keep packet files, file logs and queue dumps.
• Use --stop-timeout 30 (or stop_grace_period: 30s) so the gateway can dump its pending queue on SIGTERM.
• The image is built FROM scratch - there is no shell, so docker exec ... sh does not work.

⁠Usage

Defaults, packets printed to the container log:

docker run --rm --name egts_gateway --stop-timeout 30 \
  -p 8081:8081 \
  -v egts_gateway_data:/app/data \
  docker.io/dimahkiin/egts_gateway:latest

Authentication is disabled by default; use -p 127.0.0.1:8081:8081 instead if the port should not be reachable from other hosts, or set auth_cfg.enabled = true with auth_cfg.password.

With a TOML file:

curl -fsSL https://raw.githubusercontent.com/LdDl/go-egts/master/egts_gateway.toml -o egts_gateway.toml
docker run --rm --name egts_gateway --stop-timeout 30 \
  -p 8081:8081 \
  --mount type=bind,source="$(pwd)/egts_gateway.toml",target=/app/egts_gateway.toml,readonly \
  -v egts_gateway_data:/app/data \
  docker.io/dimahkiin/egts_gateway:latest -conf /app/egts_gateway.toml

With an .env file (note: no -conf, and the target path must be /app/.env):

docker run --rm --name egts_gateway --stop-timeout 30 \
  -p 8081:8081 \
  --mount type=bind,source="$(pwd)/.env",target=/app/.env,readonly \
  -v egts_gateway_data:/app/data \
  docker.io/dimahkiin/egts_gateway:latest

⁠Ports

This is the only listening port. Outbound destinations - EGTS relays, RabbitMQ, Valkey/Redis - are dialed by the container and need no published ports.

⁠Paths

⁠Environment

Read only when -conf is not passed. Selected variables; see .env.example⁠ for all of them.

The gateway exposes no HTTP or management endpoints.

⁠Image

Built FROM scratch with a static CGO_ENABLED=0 Go binary compiled in golang:1.25.9-alpine3.23. No shell, no package manager, no CA bundle. Size is about 6 MB.

⁠License

MIT - LICENSE.md⁠