Skip to main content
Data Pipelines are now the preferred method for loading data into the System. For details, see Load Data.
The LAT service is configurable using Service Configuration. This configuration is derived from three sources, with the following precedence order:
  1. Environment Variables
  2. Properties File
  3. Code Defaults

Configuration File Backup

When you install a new LAT instance or upgrade the existing instance, LAT creates a backup file of the /etc/lat/lat.conf as /etc/lat/override.conf and creates a new version of the /etc/lat/lat.conf file. The /etc/lat/overrirde.conf file does not control the LAT configuration. If you made prior changes to lat.conf, you must review override.conf and add any custom values into the revised lat.conf.

Environment Variables

LAT_DEFAULT_WORKERS

Default number of workers used by a newly configured pipeline.

LAT_SHUTDOWN_DURATION

Duration, in milliseconds, to wait prior to termination on shutdown.

LAT_UDT_PATH

Directory containing zero or more user defined transformation (UDT) jars. Ensure that the specified path can be accessed by the LAT (e.g., does not allow the LAT to access the home directory of an administrative user).

LAT_API_PORT

REST API and Metrics port.

LAT_DATA_PATH

Path to the LAT data directory. This directory is used to store persistent data related to pipelines (pipeline/) and sinks (sink/). In almost all cases, using the LAT Client Command Line Interface is preferred over editing the files in this directory manually. Ensure that the specified path can be accessed by the LAT (e.g., CentOS does not allow the LAT to access the home directory of an administrative user).

LAT_AUTO_START

On LAT startup, automatically starts running a Pipeline if one is present. This only supports pipelines with sources; File sources will not automatically start even if this configuration is set to true.

LAT_ALLOW_LOG_ORIGINAL_RECORDS

Allow the original records that are being loaded to be logged when errors occur. This setting must be enabled for log_original_records to be enabled. This setting only affects pipelines that log errors to the error log file.

LAT_MAX_RETRIEVABLE_ERRORS

A limit on the number of errors that you can retrieve using the pipeline errors command of the LAT client.

LAT_API_PROXY_HOST

API proxy host for authorization requests.

LAT_API_PROXY_PORT

API proxy port for Okta authorization requests.

LAT_API_OAUTH_DOMAIN

Okta authorization domain.

LAT_API_OAUTH_ENDPOINTS

A list of LAT API endpoints that Okta should apply authentication on. To override, provide a comma-delimited list, e.g., /endpoint1,/endpoint2,/endpoint3.

LAT_API_OAUTH_SERVER

Okta authorization server.

LAT_API_CERT_PATH

API cert file path. Ensure that the specified path can be accessed by the LAT (e.g., CentOS does not allow the LAT to access the home directory of an administrative user).

LAT_DNS_CACHE_TTL

The time-to-live (TTL) in seconds that the LAT should use for its DNS cache. This configuration is only supported as an Environment Variable or as Default.

LAT_MEMORY

Maximum heap memory. This configuration is only supported as an Environment Variable or as Default when running the LAT through the provided package service file or through the provided lat.sh script. If directly running the Jar JVM heap memory should be set through command line arguments.

LAT_MEMORY_DIRECT

Maximum JVM direct memory. This configuration is only supported as an Environment Variable or as Default when running the LAT through the provided package service file or through the provided lat.sh script. If directly running the Jar JVM heap memory should be set through command line arguments.

Override Environment Variables

The recommended way to manage the production service configuration when LAT is running as a daemon is using environment variables or the /etc/systemd/system/lat.service.d/override.conf file. To override LAT environment variables as a systemd service, there are two recommended commands that edit the etc/systemd/system/lat.service.d/override.conf file.
  1. Run sudo vim etc/systemd/system/lat.service.d/override.conf or sudo systemctl edit lat.
  2. Insert the environment variables to override in the file. Save and exit the editor.
Configuration File Example:
Shell
Ingest Data with Legacy LAT Reference LAT Packaging and Installation
Last modified on July 2, 2026