Troubleshooting

When you lose access to your mrxnode device, the power button lets you recover it without a keyboard, monitor, or network connection. This guide covers each recovery pattern and when to use it.

Power Button Recovery

When you lose access to your device (forgotten password, network misconfiguration, etc.), you can use the power button to recover without needing a keyboard or network connection.

Press Patterns

The power button uses different timeout windows depending on the action:

• 2-second window for quick actions (1-2 presses)
• 10-second window for reset actions (4, 5, 8, 10+ presses)

How to Perform an Action

1. Press the power button the required number of times (e.g., 10 times for factory reset)
2. Use short presses - tap and release, don't hold
3. Complete all presses within the timeout window (2 seconds for 1-2 presses, 10 seconds for others)
4. Wait - the device will perform the action after the timeout window closes
5. The device will reboot automatically after most operations

Actions

Reboot (1 press)

Restarts the device. Use this for a quick reboot.

• Press once within 2 seconds
• Device will reboot immediately
• Useful when device needs a simple restart

Shutdown (2 presses)

Safely powers off the device. Use this instead of unplugging when possible.

• Press twice within 2 seconds
• Device will shut down after a brief countdown
• To cancel: wait for the timeout without additional presses

Recovery Mode (4 presses)

Boots the device into recovery mode for advanced troubleshooting.

• Press 4 times within 10 seconds
• Device boots into the recovery system
• Use when the main system won't start properly
• Allows system diagnostics and repairs

Boot Latest System (5 presses)

Switches to the latest working system version (A/B partition switching).

• Press 5 times within 10 seconds
• Device determines the most recent good system version and boots to it
• Use when a system update caused issues
• Helps recover from failed updates

Network Reset (8 presses)

Clears all network settings and restarts. Use when:

• Device has wrong IP address
• WiFi credentials are incorrect
• Cannot connect to the device over the network

After reset:

• Press 8 times within 10 seconds
• Device returns to default network configuration
• You may need to reconfigure WiFi or static IP settings
• Device registration and user data remain intact

Factory Reset (10 presses)

Resets the device to factory defaults while preserving registration. Use when:

• Password is forgotten
• Application is severely malfunctioning
• Need a complete fresh start without re-registering

After reset:

• Press exactly 10 times within 10 seconds
• All user data and settings are erased
• Network settings are cleared
• Device registration is preserved - no support contact needed
• Device can be reconfigured immediately

Important Notes

Count carefully - The device responds to specific press counts (1, 2, 4, 5, 8, 10). Counts like 3, 6, 7, and 9 do nothing intentionally (safety feature to prevent accidental triggers).

Different timeouts - Quick actions (1-2 presses) have a 2-second window. Reset actions (4, 5, 8, 10) have a 10-second window.

Wait for completion - After pressing, wait for the device to complete its action. Do not unplug power during operations.

No confirmation prompt - Actions execute automatically after the timeout window. Make sure you press the correct number of times.

Quick Reference

Related Features

• mrxnode Overview — device setup, registration, and first connection
• How-To Guide — network and disk configuration tasks
• CLI Cheatsheet — command reference for managing the device
• Container Deployment — run and update applications on the device