Skip to main content

SDS Updater Configuration

The Datalogic SDS Updater service is responsible for checking and installing updates to the AladdinSDS service. Its configuration is stored in:

C:\ProgramData\Datalogic\SDSUpdater\config.toml

Configuration Sections​

[update] - Update Check Settings​

Controls how the updater checks for and manages new versions.

manifest_url​

  • Type: String (URL)
  • Default: https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json
  • Description: URL of the JSON manifest file containing information about available SDS versions and download links. The updater automatically fetches this file to determine if new versions are available.
  • Auto-Updated: Yes - The SDS service automatically updates this value on startup
manifest_url = "https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json"

check_interval_minutes​

  • Type: Integer (minutes)
  • Default: 60
  • Valid Range: 0 (disabled) to 1440 (24 hours)
  • Description: How often the updater automatically checks for new versions in the background. Set to 0 to disable periodic checks (manual checks via API will still work).
  • Recommended: 60 (check once per hour)
check_interval_minutes = 60

auto_check_enabled​

  • Type: Boolean
  • Default: true
  • Description: When true, the updater checks for updates immediately when it starts. When false, you must manually trigger update checks via the API.
auto_check_enabled = true

[storage] - Download Configuration​

Manages where installer files are temporarily stored.

download_directory​

  • Type: String (file path)
  • Default: downloads
  • Description: Location where downloaded SDS installer files (.msi, .deb, .rpm) are stored. Supports both relative paths (relative to the updater installation directory) and absolute paths.
  • Examples:
    • Relative: downloads or temp/updates
    • Absolute: C:/Temp/sds-downloads or D:/Updates
download_directory = "downloads"
warning

Ensure the directory has sufficient free disk space for downloading installers and has write permissions.

[sds] - Local SDS Service Connection​

Configuration for connecting to the local AladdinSDS service.

port​

  • Type: Integer (TCP port)
  • Default: 9000
  • Valid Range: 1 - 65535
  • Description: HTTP port of the local AladdinSDS service. The updater communicates with this service via HTTP to check for updates and trigger installations. This should match the port configured in your AladdinSDS service (http.port).
port = 9000

version​

  • Type: String (semantic version)
  • Description: Reflects the current version of the AladdinSDS service installed on this device. This field is automatically updated by the SDS service on startup and should not be manually edited.
  • Format: MAJOR.MINOR.PATCH (e.g., 1.1.2)
  • Auto-Updated: Yes
version = "1.1.2"

[edge] - Edge Gateway Integration​

Configuration for connecting to the Datalogic Edge platform for cloud-based device management and updates.

ip​

  • Type: String (IP address or hostname)
  • Default: localhost
  • Description: IP address or hostname of the Datalogic Edge platform. Leave empty ("") to disable Edge integration. The updater uses this connection to receive update notifications from the cloud.
  • Examples:
    • Disable: ip = ""
    • Local: ip = "localhost" (for development/testing)
    • Remote: ip = "192.168.1.100" or ip = "edge.datalogic.local"
  • Auto-Updated: Yes - The AladdinSDS service automatically updates this on startup
ip = "localhost"

port​

  • Type: Integer (TCP port)
  • Default: 1883
  • Valid Range: 1 - 65535
  • Description: MQTT broker port used for Edge platform communication. Standard MQTT port is 1883; use 8883 for MQTT over TLS if your Edge configuration requires encryption.
port = 1883

Common Configuration Tasks​

Enable Automatic Update Checks​

To enable the updater to automatically check for updates every hour:

[update]
auto_check_enabled = true
check_interval_minutes = 60

Disable Automatic Update Checks​

To disable periodic update checks (only manual checks allowed):

[update]
check_interval_minutes = 0
auto_check_enabled = false

Change Download Location​

To store downloaded installers in a custom directory:

[storage]
download_directory = "C:/Custom/Updates/Location"

Connect to Remote Edge Gateway​

To enable cloud-based updates via a remote Datalogic Edge:

[edge]
ip = "192.168.1.50"
port = 1883
  • AladdinSDS Configuration: See AladdinSDS Configuration for the main service settings, including the HTTP port (http.port) that must match the updater's [sds].port setting.
tip

Always backup the config.toml file before making changes. After modifying the configuration, restart the SDS Updater service for changes to take effect.