Troubleshooting

If ArcOS isn't working right, this page might be able to help you figure out exactly what is happening, and what you can do to fix it.

Error phases

ArcOS has several phases in which "halting" errors can occur. Errors are just unhandled Javascript exceptions: it doesn't get much more plain than that. Maybe an app malfunctioned, or I didn't account for some random edge case, whatever the case may be, if ArcOS ever does fail, it'll be displayed in one of these phases:

The dots of doom

If you've encountered a dark blue screen with three dots in the top left corner, then ArcOS failed to load, so there's no kernel, not even a single line of executed ArcOS code. This could mean that your browser is incompatible with ArcOS because it's too old or just quite simply on an unsupported platform.

The bottom of the page contains the stack trace, which indicates why ArcOS failed to load.

• If you're willingly using ArcOS in suboptimal conditions, then you don't have to report it at all.

• If you were just trying to boot ArcOS, please send a screenshot in the Discord server, so I can take a look.

Without a kernel, there are no kernel modules, and thus also no bug reporting. If you don't tell me about this, I won't know that it happened.

• If you were benchmarking ArcOS' operating conditions or performance metrics, please, I'm thrilled to hear about it. Do send me your findings in the Discord so that we can work to widen the scope of supported environments for ArcOS.

The kernel failed prematurely

If the kernel failed prematurely, then something went terribly wrong. First of all, there will be a long log in the Developer Tools console (Ctrl+Shift+I ➡️ Console) that tells you what went wrong. Premature kernel failures are really rare, so please send this in the Discord so that I can work to fix it. Be sure to include the Developer Tools Console.

ArcOS Crashed (regular)

You'll undoubtedly encounter these the most. These crashes can be caused by third-party apps, by services malfunctioning, by network errors, or by me making a silly mistake. Good thing about these crashes is the fact that ArcOS will should automatically send a detailed bug report to the servers so that authorized ArcOS administrators can take a look and report it back to me if it's a bug that needs fixing. If the bug report is just simply a third-party application malfunctioning, then the report will be closed and ignored.