Table of Contents

• Read the Status Page
• Drive and Stress-Test Failures
• Performance and Temperature
• Network Connection
• Collect Information for Support
• USB Devices and SMART Details
• Related Articles

TetherBox Troubleshooting

Open Admin → TetherBoxes and check the Health column. Online units show a health badge with an information popover listing current issues; offline units show when they were last seen. Open the affected unit for its CPU, memory, temperature, drive, network and device details.

The Issues total counts online units with Warning or Critical health across the filtered list, including units on other pages. Each unit counts once. Offline units have their own total.

Enable the Health Report for a regular summary of TetherBox and camera issues in your notification settings.

 Read the Status Page

Red needs prompt attention. Yellow indicates a condition to investigate before it affects recording. Custom or repurposed hardware should first be checked against Hardware Specifications for CPU, RAM, cooling and storage suitability.

 Drive and Stress-Test Failures

Drive Health reports the immediate condition of recording storage. A SMART error, failed probe, I/O error or ejected drive means recordings may be at risk. Open the Storage tab for drive details and logs, check the cable or enclosure, then replace unreliable storage. See Storage and Storage Hardware Recommendations.

Health popovers explain recording-storage problems and link to Storage for the findings. A hard disk's age alone does not mean it has failed and does not raise a Health warning. Staff can see age-planning notes in the Storage tab's staff details; actual read errors, media faults and reported SSD wear still raise warnings.

The stress test runs CPU, memory and storage together for about five minutes. A failure usually points to a hardware problem, not camera load:

1. Re-run an interrupted test from the Settings tab.
2. Read the first line of Error Details to identify CPU, memory or I/O.
3. Test or replace faulty RAM, power supply, drive, cable or enclosure.
4. Check cooling and reset aggressive BIOS settings on custom hardware.

A passing test shows that the hardware is stable under load. It does not show that the TetherBox has enough capacity for its cameras, which is a separate sizing question in CPU Recommendations.

 Performance and Temperature

High CPU or load usually means too many cameras, unnecessarily high stream resolution or bitrate, or AI running without suitable hardware. Compare the host with CPU Recommendations and Hardware Specifications, then reduce stream demand or add capacity.

IO wait and drive load mean the processor is waiting for storage. Check drive health, free capacity, write speed, cabling and the enclosure. Avoid SD cards, USB sticks, SMR drives and low-quality USB adapters for continuous recording. High-camera-count sites need suitable NVMe or RAID storage. See Storage Hardware Recommendations.

Overheating reduces performance and can cause recording gaps or stress-test failures. Improve airflow, remove dust, keep the unit away from direct heat and ensure cooling matches the workload. Raspberry Pi 5 uses the official 27 W USB-C supply. If CPU temperature rises steadily under normal demand, fit active cooling or use a more capable host.

 Network Connection

The Latency/Loss badge measures the route between the TetherBox and TetherX. Any packet loss is worth investigating. Use the Network tab to check interface speed, duplex, link state and error counters.

• Replace the patch lead and test another switch port if an interface reports Bad Cable or Half Duplex.
• Resolve packet loss, high latency or a slow link before diagnosing recording gaps as a software issue.
• Gigabit networking is recommended for sites with more than five cameras.

 Collect Information for Support

If the status page does not identify the fault:

1. Check the Reboots, Connections, Updates and USB tabs.
2. Record the TetherBox serial number, error messages and unusual readings.
3. Send TetherX support screenshots of the relevant status and detail panels.

USB Devices and SMART Details

On the TetherBox page, open Devices > USB to inspect attached devices, their mount points and block device paths. Refresh reloads the list. USB reset, power and eject actions can interrupt a recording drive; check the device before using them.

Open Storage and scroll to the SMART health analysis for drive attributes and their reported values. Some USB enclosures do not expose SMART attributes; missing SMART data alone does not confirm a drive fault.

Related Articles

• TetherBox Went Offline - power and Internet diagnosis
• Storage Hardware Recommendations - reliable recording drives and enclosures
• Camera Troubleshooting - camera and stream faults
• TetherBox States - expected state changes and recovery
• Support - contact TetherX