Installation and Setup

Get started with ZeroTrace in three simple steps: Prepare, Flash, and Connect.

1. Preparation

ZeroTrace includes two USB ports, each with a specific purpose.

Port	Used for	Example
COM	Updates and tools	Firmware flashing
USB	HID payloads	Keystroke injection

Tip
Use the COM port for device maintenance and firmware updates.
Use the USB port for HID payload execution.

Connect ZeroTrace to your computer using the COM port and a USB-C data cable.
Open the ZeroTrace Web Flasher in Chrome or Edge.
Click Connect, select your device, then choose Flash Firmware.
Wait about two minutes for the process to complete.
Unplug the device and power it on again.

If you see the error below:

Failed to execute 'open' on 'SerialPort'

Run the following command:

sudo usermod -a -G dialout $USER

For Arch-based distros, use:

sudo usermod -a -G uucp <user>

Log out and back in before retrying.

You are connected
You can now configure settings and launch payloads from the web dashboard.

Issue	Recommended fix
Device not detected	Try a different USB-C data cable
WiFi not visible	Wait two to three minutes and check for WiFi conflicts
Flashing fails	Ensure stable power and use a reliable cable
Timeout or error	Restart the device and verify the IP address

For persistent WiFi issues, perform a factory reset.

ZeroTrace’s RGB LED shows device status:

LED Color	State	What It Means
🔴 Red	3 Blinks (after Script Execution)	Incorrect USB port or cable (use data cable)
🔴 Red	Solid	File system error
🟢 Green	Solid	Powered on & ready
🟣 Magenta	Solid	Script running
🟠 Orange	3 Blinks	Execution canceled
🔵 Cyan	Solid	Autostart script running