Configuration Quick Reference¶

This document summarizes the key GateKeeper Conveyor settings that Tier 1 support staff may need to verify or reference during troubleshooting. It is organized by category for quick lookup.

IMPORTANT: The appsettings.json file in the source code repository is a development example only. Every production site has its own unique configuration with different IP addresses, ports, and settings. Never assume repository values match production.

Restart Required: All configuration changes require restarting the GateKeeper application to take effect.

Configuration File Location¶

What	Where
Main configuration file	`C:\gatekeeper\conveyor\appsettings.json`
Database setting overrides	`C:\gatekeeper\conveyor\data\Setting\`
Config change audit log	`C:\gatekeeper\conveyor\config-audit\config-changes.log`

Config priority: Database files override appsettings.json for validation settings only. If a setting change does not take effect, check for a matching file in the Setting\ directory and delete it.

General Settings¶

These control overall application behavior.

Setting	What It Controls	Typical Values	Where to Find
`DefaultValidationMode`	Which validation mode runs at startup	`AV50`, `Chipotle`, `CargillRfid`, `CargillSalt`, `Zfl`, `Teasdale`	ApplicationSettings section
`AutoStartValidation`	Start validation automatically on launch	`true` or `false`	ApplicationSettings section
`DataDirectory`	Where validation data is stored	`C:\gatekeeper\conveyor\data`	ApplicationSettings section
`FailuresBeforeStop`	Consecutive failures before line stops	`1` (strict) to `99` (lenient)	ApplicationSettings section
`EnableTestingTools`	Show testing tools panel in UI	`true` or `false` (usually `false` in production)	ApplicationSettings section
`KioskMode`	Touchscreen-optimized UI	`true` or `false`	ApplicationSettings section

Hardware Connection Settings¶

These define how GateKeeper connects to cameras, RFID readers, and controllers.

Setting	What It Controls	Typical Values	Where to Find
`CameraDataMode`	How camera data is collected	`Push` or `Poll`	ApplicationSettings section
`CameraListenerIpAddress`	IP for camera Push listener	`0.0.0.0` (all interfaces) or specific PC IP	ApplicationSettings section
`CameraListenerPort`	Port for camera Push listener	`3000` (default)	ApplicationSettings section
HardwareSettings `ConnectionString`	Device IP and port	e.g., `192.168.100.200:23` (camera), `192.168.100.125:5084` (RFID)	HardwareSettings array
HardwareSettings `IsEnabled`	Whether device is active	`true` or `false`	HardwareSettings array
HardwareSettings `ConnectionType`	How to connect to device	`TCP`, `Serial`, `USB`, `Mock`	HardwareSettings array

Camera Connection Strings by Type¶

Camera Type	ConnectionString Format	Example
Cognex DataMan	`CAMERA_IP:23`	`192.168.100.200:23`
Cognex Insight	`THIS_PC_IP:PORT` or `0.0.0.0:PORT`	`0.0.0.0:8890`
Zebra DS9908R	`SNAPI`	`SNAPI`

Validation Settings¶

These control how each validation mode behaves.

Setting	What It Controls	Typical Values	Modes Affected
`Reject.Enabled`	Send reject signal on failure	`true` or `false`	All modes
`Chipotle.ExpirationTolerance`	Days of tolerance for expiration date	`0` (exact) to `3` (flexible)	Chipotle
`CargillRfid.ExpirationTolerance`	Days of tolerance for expiration date	`0` (exact) to `3` (flexible)	CargillRfid
`RFID.TagExpirationSeconds`	RFID tag cache duration	`17` (default), `0` (bypass mode)	Chipotle, CargillRfid
`AV50.ActiveCameraMode`	Which cameras to validate	`Single`, `Front`, `Side`, `Both`	AV50
Camera `MinimumBarcodes`	Min barcodes per camera	`1` (default)	AV50
Camera `CameraRole`	Camera position identifier	`None`, `Front`, `Side`	AV50

Database Override Warning: Validation settings can be silently overridden by files in C:\gatekeeper\conveyor\data\Setting\. If changing these settings in appsettings.json has no effect, delete the corresponding file in that directory and restart.

Matthews Interface Settings¶

Used by Chipotle and CargillRfid modes to receive production data from the plant.

Setting	What It Controls	Typical Values
`EnableMatthewsInterface`	Enable production data TCP listener	`true` or `false`
`MatthewsPort`	TCP port for incoming data	`60251` (default)
`MatthewsAllowedIp`	Restrict connections to specific IP	Empty (allow all) or specific IP

Export Settings¶

Controls how validation results are sent to external systems.

Setting	What It Controls	Typical Values
`EnableAisExport`	Send results to AIS	`true` or `false`
`EnableMojixExport`	Send results to Mojix	`true` or `false`
`EnableMweExport`	Send results to MWE	`true` or `false`
`AisEndpointUrl`	AIS server URL	Site-specific URL
`MojixEndpointUrl`	Mojix server URL	`https://chipotle.mojixretail.io/...`
`MweEndpointUrl`	MWE server URL	Site-specific URL

Export priority (CargillRfid and Teasdale modes): Mojix first, then MWE, then AIS as fallback. Only the first enabled service is used.

Teasdale-Specific Settings¶

Used only at Teasdale Carrollton sites.

Setting	What It Controls	Typical Values
`EnableTeasdaleImporter`	Enable JSON file polling	`true` or `false`
`TeasdaleImportPath`	Directory to watch for import files	UNC network path
`TeasdaleProcessedPath`	Where processed files are moved	Local path
`TeasdalePollIntervalSeconds`	How often to check for new files	`10` (seconds)
`TeasdaleFilePrefix`	Filter files by name prefix	`RFID-CT7` (Line 7), `RFID-CT9` (Line 9)
`TeasdaleRetentionDays`	Days to keep processed files	`60`
`EnableMidnightRollover`	Auto-update lots at midnight	`true` or `false`
`MidnightWarningMinutes`	Warning time before midnight	`5` (minutes)
`EnableAutomaticLabelPrinting`	Print labels at pallet start	`true` or `false`
`TeasdaleNetworkUsername`	Network share login	Domain\username format
`TeasdaleNetworkPassword`	Network share password	Encrypted with `ENC:` prefix

Stack Light Settings¶

Controls the colored indicator lights on the conveyor.

Setting	What It Controls	Typical Values
`StackLightProfile`	Light behavior pattern	`CargillRfid`, `Teasdale`, `AV50`, `Off`
`StackLightPassDurationMs`	Green flash duration (ms)	`500` to `5000`
`StackLightFailDurationMs`	Red flash duration (ms)	`500` to `5000`
`StackLightHornOnFail`	Sound horn on failure	`true` or `false`
`StackLightHornOnWarning`	Sound horn on NOREAD	`true` or `false`

Security Settings¶

Setting	What It Controls	Typical Values
`SettingsPinHash`	SHA256 hash of the settings PIN	Hash string (or empty for no PIN)
`LockValidationControls`	Require PIN for On/Off controls	`true` or `false`

Default PIN: 867530

Logging Settings¶

Located in the Serilog section of appsettings.json.

Setting	What It Controls	Typical Values
`MinimumLevel.Default`	How much detail to log	`Information` (normal), `Debug` (verbose)
`retainedFileCountLimit`	Days of log files to keep	`14` (default)

Tip: Set the log level to Debug temporarily when troubleshooting hardware communication issues. Remember to set it back to Information afterward, as Debug logging creates very large files.

BarTender Settings (Teasdale Only)¶

Located in the BartenderSettings section of appsettings.json.

Setting	What It Controls	Typical Values
`BartenderUrl`	BarTender API server URL	`http://server:5154/api/btxml`
`DocumentFile`	Label template file path (on BarTender server)	`D:\Applications\Bartender\Labels\Teasdale.btw`
`Printer`	Target printer name (as shown in Windows)	`Zebra ZT411R (300 dpi)`

Network File Importer Settings (CargillSalt Only)¶

Setting	What It Controls	Typical Values
`EnableNetworkFileImporter`	Enable file-based production import	`true` or `false`
`NetworkFileImportPath`	Directory to watch for import files	`D:\DB`
`NetworkFileImportIntervalSeconds`	How often to check for new files	`5` to `10` (seconds)
`NetworkFilePrefix`	Filter files by name prefix	Site-specific (e.g., `PR001059`)