A box that freezes or reboots almost always shows warning signs first: memory at its limit, a full disk, high temperature or an app using too much. With that data in view you can decide whether a remote restart is enough, whether an app needs to be removed, or whether it is a hardware problem and the unit should be replaced.
"My box keeps freezing" is one of the most common complaints in a fleet, and one of the most expensive: without data, the only option is to send someone on site or ask the user to unplug it. With a bit of method, most cases can be understood and solved remotely.
Which data to look at first
Every box with the agent installed reports its status every 15 minutes: model, Android version, CPU, memory, disk, temperature, network and installed apps. For a freeze, these four help the most:
- Memory. A box with little free RAM for a sustained period starts killing processes, slows down and ends up hanging. It is the most frequent cause on budget units.
- Storage. With a nearly full disk, Android cannot store caches or update apps, and the system behaves erratically.
- Temperature. A hot unit throttles its performance to protect itself and, in extreme cases, reboots on its own. It usually happens with boxes tucked behind the TV with no ventilation.
- Installed apps. One extra app, or one preinstalled at the factory, may be the one eating memory or CPU. Always check the list before blaming the hardware.
How to read the symptoms
- Freezes after hours of use and improves after a restart: usually memory. Something fills it up over time.
- Reboots on its own, especially in summer or at peak hours: suspect temperature.
- Slow from day one: check the disk and preinstalled apps.
- Only one model is affected: compare with other boxes of the same model. If they all show the same pattern, the problem is the unit or a common app, not one particular customer.
Every box's status in one dashboard
Memory, disk, temperature and apps for each device, so you can decide before going on site.
What you can do remotely
- Restart the box. Remote restart works with and without root. It fixes memory-related freezes without bothering the user.
- Uninstall or eradicate the offending app. If an app uses too much, it can be removed remotely, and the rule can apply to a whole model.
- Run commands. Those that need no privileges work without root; some do need it.
- See the screen. A real screenshot requires the agent to be a system app or to have root; otherwise you get a diagnostic board with the device status. More details on the compatibility page.
When it is hardware
If the problem comes back after restarting, freeing space and removing apps, and the box still shows high temperature or exhausted memory under light use, the unit has probably had it. Replacing it is better than piling up visits and support calls. Having the model and the data at hand also helps you decide what to replace it with.
Common mistakes
- Restarting and closing the case. If it happens again, the restart only masked the symptom. Find out what is filling the memory.
- Blaming the network. A freeze is not the same as a choppy picture; for that case, see how to tell network from box.
- Looking at a single box. An isolated case may be the customer; the same pattern across several boxes of one model is a common cause.
What to do now
- Note which boxes generate the most freeze or reboot complaints.
- Check memory, disk, temperature and installed apps on each.
- Try a remote restart first and, if it comes back, remove the suspect app or plan a replacement.