Troubleshooting
Solutions to common issues with Hyperborea. If your problem is not covered here, ask for help in the Hyperborea Discord.
Machine Not Detected by Fitness App
If your fitness app cannot find your machine when scanning for Bluetooth devices:
- Confirm Hyperborea is running on the console and shows the dashboard with live metrics.
- Check that Bluetooth is enabled on both the console and the device running your fitness app.
- Grant Bluetooth permissions to your fitness app if prompted by your phone or tablet's operating system.
- Move closer to the console. BLE range is approximately 10 meters (30 feet).
- Restart the Hyperborea app on the console — close it fully, then reopen it.
- Restart your fitness app and scan for devices again.
- Restart the console if the issue persists. Power it off, wait 10 seconds, and power it back on.
Updates Not Installing
The Hyperborea APK updates itself automatically over Wi-Fi. If you're not on the latest version:
- Check the console's Wi-Fi connection. Updates only download when the console is online.
- Reopen the app. A downloaded update takes effect the next time you open Hyperborea.
- Wait a bit. The console checks for updates periodically rather than instantly.
How to Get Help
If none of the above solutions resolve your issue, ask for help in the Hyperborea Discord. We can help troubleshoot your issue.
You can also use the built-in Get Help feature in the app: go to Settings > System > Get Help. This uploads device diagnostics and gives you a support code — share it in Discord so we can look up your device info.
When asking for help, include:
- Your support code from Get Help (if available)
- Your machine model name
- The fitness app you are using
- A brief description of the issue and any error messages you see
- Steps you have already tried from this guide