Most global server parameters are defined in the XML configuration file. On Linux, the file is located at /opt/traccar/conf/. On Windows, the location can be set during installation, but by default it is C:\Program Files\Traccar\conf. You can edit this file with any text editor -- just ensure it remains valid XML and that special characters are properly escaped.
Some parameters can be configured as attributes on Device, Server, and other objects through the web app. Refer to the badge next to each attribute key to see where a parameter can be used.
For Boolean settings, any value left unspecified is interpreted by the server as false.
You can also override configuration values with environment variables, which take precedence over the XML file. To enable this, set CONFIG_USE_ENVIRONMENT_VARIABLES to true. To convert config key to an environment variable key replace dots with underscore and convert the rest to screaming snake case. For example, mail.smtp.fromName will be MAIL_SMTP_FROM_NAME.
List of available configuration parameters:
Network interface for the protocol. If not specified, the server will bind to all interfaces.
Port number for the protocol. Most protocols use TCP on the transport layer. Some protocols use UDP. Some support both TCP and UDP.
List of devices for polling protocols. The list should contain unique IDs separated by commas. Used only for polling protocols.
Polling interval in seconds. Used only for polling protocols.
Enable SSL support for the protocol. Not all protocols support this.
Connection timeout value in seconds. Because sometimes there is no way to detect a lost TCP connection, old connections stay in an open state. On most systems there is a limit on the number of open connections, so this leads to problems with establishing new connections when the number of devices is high or device data connections are unstable.
Device password. Commonly used in some protocols for sending commands.
Device password. Commonly used in some protocols for sending commands.
Default protocol mask to use. Currently used only by Skypatrol protocol.
Custom message length. Currently used only by H2 protocol for specifying binary message length.
Enable extended functionality for the protocol. The reason it's disabled by default is that not all devices support it.
Decode string as UTF8 instead of ASCII. Only applicable for some protocols.
Enable CAN decoding for the protocol. Similar to 'extended' configuration, it's not supported for some devices.
Indicates whether server acknowledgment is required. Only applicable for some protocols.
Default value: false
Ignore device-reported fix time. Useful in case some devices report invalid time. Currently only available for GL200 protocol.
Decode additional TK103 attributes. Not supported for some devices.
Use long date format for Atrack protocol.
Use decimal fuel value format for Atrack protocol.
Indicates additional custom attributes for Atrack protocol.
Custom format string for Atrack protocol.
Frame mask for Atrack protocol.
Protocol configuration. Required for some devices for decoding incoming data.
Alarm mapping for Atrack protocol.
Indicates whether TAIP protocol should have prefixes for messages.
Some devices require server address confirmation. Use this parameter to configure correct public address.
Protocol type for Suntech.
Suntech HBM configuration value.
Format includes ADC value.
Format includes RPM value.
Format includes temperature values.
Disable commands for the protocol. Not all protocols support this option.
Protocol format. Used by protocols that have configurable message format.
Protocol date format. Used by protocols that have configurable date format.
Device time zone. Most devices report UTC time, but in some cases devices report local time, so this parameter needs to be configured for the server to be able to decode the time correctly.
ORBCOMM API access id.
ORBCOMM API password.
Smartcar management token used for webhook verification.
Minimum accuracy to include. If the value is lower, it will be set to zero.
Default value: 10.0
Use alternative format for the protocol of commands.
Default value: false
Protocol format includes a language field.
Default value: false
If not zero, enable buffering of incoming data to handle ordering locations. The value is threshold for buffering in milliseconds.
Default value: 3000L
Server wide connection timeout value in seconds. See protocol timeout for more information.
Send device responses immediately before writing it in the database.
Number of Netty boss threads. If not specified or zero, Netty default value is used.
Default value: 0
Number of Netty worker threads. If not specified or zero, Netty default value is used.
Default value: 0
Address for uploading aggregated anonymous usage statistics. Uploaded information is the same as what you can see on the statistics screen in the web app. It does not include any sensitive data (e.g. locations).
Default value: "https://www.traccar.org/analytics/"
Fuel drop threshold value. When fuel level drops from one position to another by more than this value, an event is generated.
Default value: 0.0
Fuel increase threshold value. When fuel level increases from one position to another by more than this value, an event is generated.
Default value: 0.0
Device fuel tank capacity in liters.
Speed limit value in knots.
Default value: 0.0
Disable device sharing on the server.
Speed limit threshold multiplier. For example, if the speed limit is 100, but we only want to generate an event if the speed is higher than 105, this parameter can be set to 1.05. Default multiplier is 1.0.
Default value: 1.0
Minimal overspeed duration to trigger the event. Value in seconds.
Relevant only for geofence speed limits. Use the lowest speed limit from all geofences.
Driver behavior acceleration threshold. Value is in meter per second squared.
Driver behavior braking threshold. Value is in meter per second squared.
Do not generate an alert event if the same alert was present in the last known location.
Default value: true
If the speed is above specified value, the object is considered to be in motion. Default value is 0.01 knots.
Default value: 0.01
Enable in-memory database instead of an SQL database.
Path to the database driver JAR file. Traccar includes drivers for MySQL, PostgreSQL and H2 databases. If you use one of those, you don't need to specify this parameter.
Database driver Java class. For H2 use 'org.h2.Driver'. MySQL driver class name is 'com.mysql.jdbc.Driver'.
Database connection URL. By default Traccar uses H2 database.
Database user name. Default administrator user for H2 database is 'sa'.
Database user password. Default password for H2 admin (sa) user is empty.
Path to Liquibase master changelog file.
Default value: "./schema/changelog-master.xml"
Database connection pool size. Default value is defined by the HikariCP library.
SQL query to check connection status. Default value is 'SELECT 1'. For Oracle database you can use 'SELECT 1 FROM DUAL'.
Default value: "SELECT 1"
Store original HEX or string data as "raw" attribute in the corresponding position.
Throttle unknown device database queries when it sends repeated requests.
Automatically register unknown devices in the database.
Default category for auto-registered devices.
The group id assigned to auto-registered devices.
Automatically register unknown devices with regex filter.
Store empty messages as positions. For example, heartbeats.
Device limit for self registered users. Default value is -1, which indicates no limit.
Default value: -1
Default user expiration for self registered users. Value is in days. By default no expiration is set.
LDAP server URL. For more info, check <a href="https://www.traccar.org/ldap/">LDAP config</a>.
LDAP server login.
LDAP server password.
Force LDAP authentication.
LDAP user search base.
LDAP attribute used as user id. Default value is 'uid'.
Default value: "uid"
LDAP attribute used as username. Default value is 'cn'.
Default value: "cn"
LDAP attribute used as user email. Default value is 'mail'.
Default value: "mail"
LDAP custom search filter. If not specified, '({idAttribute}=:login)' will be used as a filter.
LDAP custom admin search filter.
LDAP admin user group. Used if custom admin filter is not specified.
List of OpenID Connect clients for the built-in provider. Value should be a comma-separated list of 'clientId:clientSecret:redirectUri' entries. Multiple redirect URIs can be specified using '|' as a separator.
Force OpenID Connect authentication. When enabled, the Traccar login page will be skipped and users are redirected to the OpenID Connect provider.
OpenID Connect Client ID. This is a unique ID assigned to each application you register with your identity provider. Required to enable SSO.
OpenID Connect Client Secret. This is a secret assigned to each application you register with your identity provider. Required to enable SSO.
OpenID Connect Issuer (Base) URL. This is used to automatically configure the authorization, token and user info URLs if provided.
OpenID Connect Authorization URL. This can usually be found in the documentation of your identity provider or by using the well-known configuration endpoint, e.g. https://auth.example.com/.well-known/openid-configuration Required to enable SSO if openid.issuerUrl is not set.
OpenID Connect Token URL. This can be found the same way as openid.authUrl. Required to enable SSO if openid.issuerUrl is not set.
OpenID Connect User Info URL. This can be found the same way as openid.authUrl. Required to enable SSO if openid.issuerUrl is not set.
OpenID Connect group scope claim name. If this is not provided, Traccar will use the "groups" scope name.
Default value: "groups"
OpenID Connect group to restrict access to. If this is not provided, all OpenID users will have access to Traccar. This option will only work if your OpenID provider supports the groups scope.
OpenID Connect group to grant admin access. If this is not provided, no groups will be granted admin access. This option will only work if your OpenID provider supports the groups scope.
If no data is reported by a device for the given amount of time, status changes from online to unknown. Value is in seconds. Default timeout is 10 minutes.
Default value: 600L
List of protocol names to ignore offline status. Can be useful to not trigger status change when devices are configured to disconnect after reporting a batch of data.
Path to the media folder. Server stores audio, video and photo files in that folder. Sub-folders will be automatically created for each device by unique ID.
Default value: "./media"
Optional parameter to specify a network interface for the web interface to bind to. By default, the server will bind to all available interfaces.
Web interface TCP port number. By default, Traccar uses port 8082. To avoid specifying port in the browser you can set it to 80 (default HTTP port).
Default value: 8082
Path to the web app folder.
Default value: "./web"
Path to a folder with overrides. It can be used for branding to keep custom logos in a separate place.
Default value: "./override"
WebSocket connection timeout in milliseconds. Default timeout is 5 minutes.
Default value: 300000L
Authentication session timeout in seconds. By default, there is no timeout.
Enable database access console via '/console' URL. Use only for debugging. Never use in production.
Server debug version of the web app. Not recommended to use for performance reasons. It is intended to be used for development and debugging purposes.
A token to log in as a virtual admin account. Can be used to restore access in case of issues with regular admin login. For example, if a password is lost and can't be restored.
Cross-origin resource sharing origin header value.
Cache control header value. By default, resources are cached for one hour.
Default value: "max-age=3600,public"
Path to localization files.
Default value: "./templates/translations"
Enable TOTP authentication on the server.
Server attribute that indicates that TOTP authentication is required for new users.
Host for raw data forwarding.
Position forwarding format. Available options are "url", "json" and "kafka". Default is "url".
Default value: "url"
Position forwarding AMQP exchange.
Default value: "traccar"
Position forwarding Kafka topic or AMQP routing key.
Default value: "positions"
URL to forward positions. Data is passed through URL parameters. For example, {uniqueId} for device identifier, {latitude} and {longitude} for coordinates.
Additional HTTP header that can be used for authorization.
Enable position forwarding retries. When enabled, additional attempts are made to deliver positions. If initial delivery fails because of an unreachable server or an HTTP response different from '2xx', the software waits for 'forward.retry.delay' milliseconds to retry delivery. On subsequent failures, this delay is duplicated. If forwarding is retried for 'forward.retry.count', retrying is canceled and the position is dropped. Positions pending delivery are limited to 'forward.retry.limit'. If this limit is reached, positions are discarded.
Position forwarding retry first delay in milliseconds. Can be set to anything greater than 0. Defaults to 100 milliseconds.
Default value: 100
Position forwarding retry maximum retries. Can be set to anything greater than 0. Defaults to 10 retries.
Default value: 10
Position forwarding retry pending positions limit. Can be set to anything greater than 0. Defaults to 100 positions.
Default value: 100
Events forwarding format. Available options are "json" and "kafka". Default is "json".
Default value: "json"
Events forwarding AMQP exchange.
Default value: "traccar"
Events forwarding Kafka topic or AMQP routing key.
Default value: "events"
Events forwarding URL.
Events forwarding headers. Example value: FirstHeader: hello SecondHeader: world
Root folder for all template files.
Default value: "templates"
Log emails instead of sending them via SMTP. Intended for testing purposes only.
Restrict global SMTP configuration to system messages only (e.g. password reset).
Force SMTP settings from the config file and ignore user attributes.
The SMTP server to connect to.
The SMTP server port to connect. Defaults to 25.
Default value: 25
Email transport protocol. Default value is "smtp".
Default value: "smtp"
If true, enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands.
If true, requires the use of the STARTTLS command. If the server doesn't support the STARTTLS command, or the command fails, the connect method will fail.
If set to true, use SSL to connect and use the SSL port by default.
If set to "*", all hosts are trusted. If set to a whitespace separated list of hosts, those hosts are trusted. Otherwise, trust depends on the certificate the server presents.
Specifies the SSL protocols that will be enabled for SSL connections.
SMTP connection username.
SMTP connection password.
Email address to use for SMTP MAIL command.
The personal name for the email from address.
SMS API service full URL. Enables SMS commands and notifications.
SMS API authorization header name. Default value is 'Authorization'.
Default value: "Authorization"
SMS API authorization header value. This value takes precedence over user and password.
SMS API basic authentication user.
SMS API basic authentication password.
SMS API body template. Placeholders {phone} and {message} can be used in the template. If value starts with '{' or '[', server automatically assumes JSON format.
AWS Access Key with SNS permission.
AWS Secret Access Key with SNS permission.
AWS Region for SNS service. Make sure to use regions that are supported for messaging.
Command sender type for the device. This overrides standard data or text commands with API-based commands. For example, it can be Traccar Client push commands.
Firebase service account JSON for push commands.
Google Find Hub service URL.
Google Find Hub service API key.
Enabled notification options. Comma-separated string is expected. Example: web,mail,sms
Default value: "web,mail,command"
If the event time is too old, we should not send notifications. This parameter is the threshold value in milliseconds. Default value is 15 minutes.
Default value: 15 * 60 * 1000L
Traccar notification API key.
Firebase service account JSON for push notifications.
Pushover notification user name.
Pushover notification user token.
Telegram notification API key.
Telegram notification chat id to post messages to.
Telegram notification send location message.
WhatsApp Cloud API permanent access token.
WhatsApp Cloud API phone number id.
WhatsApp Cloud API template name.
WhatsApp Cloud API template language code. Default value is "en_US".
Default value: "en_US"
Enable user expiration email notification.
User expiration reminder. Value in milliseconds.
Enable device expiration email notification.
Device expiration reminder. Value in milliseconds.
Block notifications for specific users. The value should be a comma-separated list of internal user ids.
Maximum time period for reports in seconds. Can be useful to prevent users from requesting unreasonably long reports. By default, there is no limit.
Time threshold for fast reports. Fast reports are more efficient, but less accurate and missing some information. The value is in seconds. One day by default.
Default value: 86400L
Enable new trips calculation logic.
Default value: true
Distances above the minimum are considered trips.
Default value: 200L
If the device doesn't move for the minimum duration, it is considered a stop.
Default value: 180L
Gaps of more than specified time are treated as stop/trip/stop based on average speed. Default value is one hour.
Default value: 3600L
Trips less than minimal duration and minimal distance are ignored. 300 seconds and 500 meters are default.
Default value: 500L
Trips less than minimal duration and minimal distance are ignored. 300 seconds and 500 meters are default.
Default value: 300L
Parking shorter than the minimum duration does not split a trip. Default is 300 seconds.
Default value: 300L
Gaps of more than specified time are counted as stops. Default value is one hour.
Default value: 3600L
Flag to enable ignition use for trips calculation.
Default value: false
Ignore odometer value reported by the device and use server-calculated total distance instead. This is useful if device reports invalid or zero odometer values.
Default value: false
Boolean flag to enable or disable position filtering.
Default value: true
Filter invalid (valid field is set to false) positions.
Filter zero coordinates. Zero latitude and longitude are theoretically valid values, but in practice they usually indicate invalid GPS data.
Filter duplicate records (duplicates are detected by time value).
Filter messages that do not have GPS location. If they are not filtered, they will include the last known location.
Filter records with fix time in the future. The value is specified in seconds. Records that have fix time more than the specified number of seconds later than current server time would be filtered out.
Default value: 86400L
Filter records with fix time in the past. The value is specified in seconds. Records that have fix time more than the specified number of seconds before current server time would be filtered out.
Filter positions with accuracy less than specified value in meters.
Filter cell and wifi locations that are coming from geolocation provider.
Filter positions with exactly zero speed values.
Filter records by distance. The value is specified in meters. If the new position is closer than this value to the last one, it gets filtered out.
Filter records by Maximum Speed value in knots. Can be used to filter jumps to far locations even if Position appears valid or if Position `speed` field reported by the device is also within limits. Calculates speed from the distance to the previous position and the elapsed time. Tip: Shouldn't be too low. Start testing with values at about 25000.
Filter position if time from previous position is less than specified value in seconds.
Throttle positions if the daily limit is exceeded for the device.
Throttling interval if the limit is exceeded. The value is in seconds.
If false, the server expects all locations to come sequentially (for each device). Filter checks for duplicates, distance, speed, or time period only against the location that was last received by the server. If true, the server expects locations to come in random order (since a tracking device might go offline). Filter checks for duplicates, distance, speed, or time period against the preceding position. Important: setting this to true can cause potential performance issues.
Time limit for filtering in seconds. If the time difference between when the last position was received by the server and when a new position is received by the server is greater than this limit, the new position will not be filtered out.
Enable attributes skipping. Attribute skipping can be enabled in the config or device attributes. If position contains any attribute mentioned in "filter.skipAttributes" config key, position is not filtered out.
Attribute skipping can be enabled in the config or device attributes. If position contains any attribute mentioned in "filter.skipAttributes" config key, position is not filtered out.
Default value: ""
Override device time. Possible values are 'deviceTime' and 'serverTime'
List of protocols to enable. If not specified, Traccar enables all protocols that have port numbers listed. The value is a comma-separated list of protocol names. Example value: teltonika,osmand
List of protocols for overriding time. If not specified, override is applied globally. The list consists of protocol names that can be separated by a comma or a single space character.
Replaces coordinates with the last known coordinates if the change is less than 'coordinates.minError' meters or more than 'coordinates.maxError' meters. Helps avoid coordinate jumps during parking periods or jumps to zero coordinates.
Distance in meters. Distances below this value get handled as explained in 'coordinates.filter'.
Distance in meters. Distances above this value get handled as explained in 'coordinates.filter'.
Enable saving device IP address information. Disabled by default.
Use linked driver id for positions if a device does not send driver id.
Enable copying of missing attributes from last position to the current one. Might be useful if device doesn't send some values in every message.
List of attributes to copy. Attributes should be separated by a comma without any spacing. For example: alarm,ignition
Include device attributes in the computed attribute context.
Include last position attributes in the computed attribute context.
Enable local variables declaration.
Enable loop processing.
Enable new instance creation. When disabled, parsing a script/expression using 'new(...)' will throw a parsing exception.
Boolean flag to enable or disable reverse geocoder.
Default value: true
Reverse geocoder type. Check reverse geocoding documentation for more info.
Default value: "locationiq"
Geocoder server URL. Applicable only to Nominatim and Gisgraphy providers.
Provider API key. Most providers require API keys.
Default value: "pk.689d849289c8c63708068b2ff1f63b2d"
Language parameter for providers that support localization (e.g. Google and Nominatim).
Address format string. Default value is %h %r, %t, %s, %c. See AddressFormat for more info.
Cache size for geocoding results.
Disable automatic reverse geocoding requests for all positions.
Default value: true
Optional parameter to specify minimum distance for new reverse geocoding request. If distance is less than specified value (in meters), then Traccar will reuse last known address.
Perform geocoding when preparing reports and sending notifications.
Default value: true
Boolean flag to enable LBS location resolution. Some devices send cell tower information and Wi-Fi points when GPS location is not available. Traccar can determine coordinates based on that information using third-party services. Default value is false.
Provider to use for LBS location. Available options: google, unwired and opencellid. By default, google is used. You have to supply a key that you get from the corresponding provider. For more information, see LBS geolocation documentation.
Geolocation provider API URL address. Not required for most providers.
Provider API key. OpenCellID service requires API key.
Boolean flag to apply geolocation to invalid positions.
Reuse last geolocation result if network details have not changed.
Process geolocation only when Wi-Fi information is available. This makes the result more accurate.
Default MCC value to use if device doesn't report MCC.
Default MNC value to use if device doesn't report MNC.
Boolean flag to enable speed limit API to get speed limit values depending on location. Default value is false.
Provider to use for speed limit. Available options: overpass. By default overpass is used.
Speed limit provider API URL address.
Search radius for speed limit. Value is in meters. Default value is 100.
Default value: 100
Override latitude sign / hemisphere. Useful in cases where value is incorrect because of device bug. Value can be N for North or S for South.
Override longitude sign / hemisphere. Useful in cases where value is incorrect because of device bug. Value can be E for East or W for West.
Jetty request log path. The path must include the string "yyyy_mm_dd", which is replaced with the actual date when creating and rolling over the file. Example: ./logs/jetty-yyyy_mm_dd.request.log
Set the number of days before rotated request log files are deleted.
Disable systemd health checks.
If this parameter is set, Traccar will monitor drops in the number of stored messages. If it drops by more than the threshold, it will mark the service as failing for systemd. Threshold is a value from 0.0 to 1.0. For example, value 0.7 means that the number of messages in the last period is only 70% of what it was in the previous period.
Sets SameSite cookie attribute value. Supported options: Lax, Strict, None.
Enables persisting Jetty sessions to the database.
Public URL for the web app. Used for notifications, report links, and OpenID Connect. If not provided, Traccar will attempt to get a URL from the server IP address, but it might be a local address.
Show logs from unknown devices.
Enable commands for a shared device.
Enable reports for a shared device.
Enable MCP service.
Output logging to the standard terminal output instead of a log file.
Log executed SQL queries.
Log file name. For rotating logs, a date is added to the end of the file name for non-current logs.
Default value: "./logs/tracker-server.log"
Logging level. Default value is 'info'. Available options: off, severe, warning, info, config, fine, finer, finest, all.
Default value: "info"
Print full exception traces. Useful for debugging. By default shortened traces are logged.
Create a new log file daily. Helps with log management. For example, downloading and cleaning logs. Enabled by default.
Default value: true
If all bytes are printable characters, log network data as text instead of HEX.
Default value: true
Log file rotation interval. The default rotation interval is once a day. This option is ignored if 'logger.rotate' = false. Available options: day, hour.
Default value: "day"
A list of position attributes to log.
Default value: "time,position,speed,course,accuracy,result"
Broadcast method. Available options are "multicast" and "redis". By default, (if the value is not specified or does not match available options) server disables broadcast.
Multicast interface. It can be either an IP address or an interface name.
Multicast address or Redis URL for broadcasting synchronization events.
Multicast port for broadcasting synchronization events.
Flag to mark secondary servers. Some tasks, like scheduled reports, will be executed on the main server only.