OverWatch ELD Setup Guide

Click a section on the left to open setup instructions.

1. Download OverWatch ELD

Go to the downloads page and click Download OverWatch ELD.

Open Downloads PageDownload Installer

2. Run the Installer

  1. Open your Downloads folder.
  2. Double-click OverWatchELD-win-Setup.exe.
  3. Follow the installer prompts.
  4. Wait for installation to complete.

3. Windows Security Warning

Windows may show a warning because the app is new or not signed yet.
  1. Click More info.
  2. Click Run anyway.
  3. Allow the installer to continue.

4. Open OverWatch ELD

After installation, open OverWatch ELD from:

Start Menu → OverWatch ELD

You may also have a desktop shortcut.

5. Use the Correct Bot Address

When setting up the app, use this Bot API address:

https://overwatcheld.up.railway.app

6. Add the Discord Bot to Your Server

Click the button below, choose your Discord server, and authorize the bot.

Add Discord Bot to Server

7. Link Your Discord / VTC

  1. Open your Discord server.
  2. Type !link in a channel where the bot can respond.
  3. The bot gives you a link code.
  4. Open OverWatch ELD.
  5. Enter the link code when prompted.
  6. After linking, ELD connects to your VTC/Discord server.

8. Companion App Access

The companion app runs locally from the ELD on port 5234.

On the same PC:

http://127.0.0.1:5234

On a phone/tablet using the same Wi-Fi:

http://YOUR-PC-IP:5234

9. Allow Companion Through Firewall

If your phone cannot connect to the companion app, open PowerShell as Administrator and run:

New-NetFirewallRule -DisplayName "OverWatchELD Companion 5234" -Direction Inbound -Protocol TCP -LocalPort 5234 -Action Allow

10. Auto Updates

OverWatch ELD only needs to be installed once.

  1. Open OverWatch ELD.
  2. The app checks for updates automatically.
  3. If a newer version is found, it downloads in the background.
  4. When prompted, click Yes to restart and finish updating.

11. Install & Run ATS Telemetry Server

OverWatch ELD needs the telemetry server running so it can read American Truck Simulator data like speed, location, fuel, damage, and job/load status.

Step 1: Download the Telemetry Server

  1. Open the OverWatch ELD downloads page.
  2. Download the ATS Telemetry Server/Reader if it is listed separately.
  3. If it is included with OverWatch ELD, continue to the next step.

Step 2: Install the ATS Telemetry Plugin

  1. Close American Truck Simulator.
  2. Open the telemetry server folder.
  3. Copy the telemetry plugin files into your ATS plugins folder.
  4. The common ATS plugin folder is:

Documents\American Truck Simulator\plugins

If the plugins folder does not exist, create it.

Step 3: Start the Telemetry Server

  1. Run the telemetry server as Administrator if needed.
  2. Make sure it starts without errors.
  3. Leave it running while using OverWatch ELD and ATS.

Step 4: Start ATS

  1. Open ATS.
  2. Load into your profile.
  3. Enter the truck.
  4. Drive or start a job so telemetry data becomes active.

Step 5: Connect OverWatch ELD

  1. Open OverWatch ELD.
  2. Go to the main dashboard.
  3. Verify speed, duty status, location, or telemetry status updates.
  4. If using VTC mode, make sure your bot address is https://overwatcheld.up.railway.app.
ATS must be restarted after installing the telemetry plugin. ELD cannot read ATS telemetry until the plugin is loaded by the game.

12. ATS Load Scanner & Create Load Updates

The new Create Load scanner reads your ATS base game data plus active local and Steam Workshop mods from your current ATS profile. It uses each mod's manifest.sii category first, then checks the def files directly, so cargo/trailer packs can still be found even when the manifest category is missing or wrong.

Base ATSActive local modsSteam Workshop modsTrailersCargoFreight/economy cargo

What the scanner now uses

  • ATS base game seed: keeps Create Load usable even without mods.
  • Active ATS profile mods: reads enabled mods instead of every installed mod.
  • Manifest category: checks category in manifest.sii first.
  • Direct file parsing: also scans cargo/trailer text inside .sii and .sui files.

Only these mod types are used for Create Load

  • Trailer mods
  • Cargo mods
  • Freight/economy cargo packs that contain cargo definitions

These are skipped automatically

  • Map/expansion mods unless they also contain usable cargo/trailer definitions
  • Truck-only mods
  • Sound mods
  • Graphics/weather/texture mods
  • Traffic/AI, UI, physics, tuning, and paintjob-only mods
  • Broken or corrupt .scs archives that cannot be opened

How to refresh Create Load

  1. Open ATS and make sure the profile has the trailer/cargo mods enabled.
  2. Open OverWatch ELD.
  3. Go to Create Load.
  4. Click Refresh.
  5. Open Advanced Scanner Details to confirm which sources were scanned or skipped.
If a mod says it was scanned with thousands of matching def files, the scanner opened it. If the cargo/trailer count is still low, the mod may not contain standard cargo/trailer definitions, may be a map/support pack, or may require a matching trailer/cargo add-on.

Common scanner messages

  • detected as Map and skipped → Normal for map/expansion mods.
  • detected as Truck and skipped → Normal for truck-only mods.
  • Could not open archive → The .scs file is corrupt, locked, encrypted, or not a normal zip-format archive.
  • Fallback cargo/trailer seed was used → No usable cargo/trailer defs were found, so ELD kept default options available.
Best practice: keep cargo packs and trailer packs enabled together in the same ATS profile, then press Refresh inside Create Load before building a custom dispatch load.

13. Connect to Vehicle (Start Driving)

OverWatch ELD only receives data when you are inside a truck and actively driving or on a job in American Truck Simulator.

  1. Start ATS and select your profile.
  2. Load into the game world and enter a truck.
  3. Pick up a load or start driving.
  4. Open OverWatch ELD and verify speed, duty status, location, map updates, and truck data.
OverWatch ELD does NOT connect to menus. You must be inside a truck and actively in-game for telemetry to work.

14. VTC Window Navigation

The VTC window is where drivers and managers can access company tools, live tracking, roster information, maintenance, performance, and Discord-connected features.

Core areas

  • VTC Home: company overview, announcements, fleet snapshot, and activity feed.
  • Live Map: active driver locations and convoy tracking.
  • Roster: driver list, Discord names, ranks, performance, and profiles.
  • Maintenance: truck condition, inspections, malfunctions, and service status.
  • Performance: miles, loads, safety, and VTC driver performance.
  • Dispatch / Loads: assigned loads, active loads, pickup status, delivery tracking, and Discord load activity.

Admin / Manager tools

  • Owner/Admin: can manage settings and VTC tools.
  • Manager: may access roster, fleet, dispatch, or maintenance controls.
  • Driver: can view driver tools and assigned VTC features.
If a VTC button is missing, your account may not be linked, your Discord role may not have access, or the VTC server may not be configured yet.

15. Shortcut Keys

OverWatch ELD includes keyboard shortcuts to quickly control the app without using the mouse.

  • Ctrl + 1 → Dashboard
  • Ctrl + 2 → Logs
  • Ctrl + 3 → VTC Window
  • Ctrl + D → Driving
  • Ctrl + O → On Duty
  • Ctrl + S → Sleeper Berth
  • Ctrl + F → Off Duty
  • Ctrl + Shift + C → Open Companion QR
Some shortcuts may depend on your version or user role.

16. Check Open Ports (Companion Verification)

This verifies that the OverWatch ELD Companion App is running and accessible on port 5234.

PowerShell

Get-NetTCPConnection -LocalPort 5234

Command Prompt

netstat -ano | findstr :5234

Browser test

http://127.0.0.1:5234

http://YOUR-IP:5234

If the port is not open, restart OverWatch ELD and make sure the Companion API started successfully.

17. Discord Bot Commands

Use these commands inside your Discord server where the OverWatch ELD bot is installed.

Getting Started

  • !link → Generate a code to connect your ELD to the VTC
  • !unlink → Disconnect your ELD from the VTC
  • !status → Check bot status and connection

Driver Commands

  • !myinfo → View driver stats and info
  • !logs → View recent logs/activity
  • !loads → View active or recent loads

Dispatch Commands

  • !dispatch → Open dispatch menu or send message
  • !reply → Reply to dispatch messages

Admin / Setup Commands

  • !setdispatchchannel → Set dispatch channel
  • !setbolchannel → Set BOL channel
  • !setlogschannel → Set logs channel
  • !setinspectionchannel → Set inspection channel
  • !setleaderboardchannel → Set leaderboard channel
Some commands require Admin, Owner, or Manager roles in your Discord server.

Need Help?

If setup does not work, verify:

  • The Discord bot was added to your server.
  • You used the correct bot address.
  • You entered the correct !link code.
  • Your firewall allows port 5234 for companion access.
  • For Create Load, ATS has the trailer/cargo mods enabled in the active profile.
Back to HomeDownloads