Troubleshooting tools

On this page

This page explains the tools in 9. Troubleshooting in the Atlas folder, at %windir%\AtlasDesktop. Start with the health check, then use the tool that matches your problem.

Check Atlas health

9. Troubleshooting then Check Atlas Health.cmd reports what Atlas installed on your PC. It also lists the recorded toggle choices and install tweaks that have changed since. It doesn’t change anything.

The check covers machine-wide settings and the settings of the account you run it from. Run it from the account whose settings you care about.

A reported difference isn’t always a fault. It may be a change you made yourself, in Windows or with another tool. Read the report before you change anything:

  • To apply a toggle choice again, run its file in the Atlas folder. The report names each one.
  • Review changed install tweaks one at a time, and decide whether you want them back.
  • Reinstalling Atlas doesn’t run one-time tweaks again.

If Atlas isn’t installed, or the check can’t run, the report says so.

Network

9. Troubleshooting then Network resets your network adapters:

  • Reset Network to Atlas Default.cmd applies Atlas’s network adapter settings again.
  • Reset Network to Windows Default.cmd resets the network stack and adapters to the Windows defaults. This can take a minute.

Restart afterwards. The Windows reset also clears IP settings, so note any static IP address or custom DNS servers you use first.

Repair Windows Components

Repair Windows Components.cmd repairs damaged Windows components and system files with DISM and System File Checker (SFC). It can take a long time, and needs an internet connection to download missing files. It doesn’t undo Atlas’s settings. Restart when it recommends.

Microsoft Store

Fix MS Store Issues.cmd runs StoreFixer to repair common Microsoft Store problems.

When Microsoft Store can’t update during Get ready, Atlas Manager tries the same repair among others.

Installer errors 2502 and 2503

Fix Errors 2502 and 2503.cmd fixes Windows Installer errors 2502 and 2503 by resetting the permissions of the Windows temporary folder. Try it when an app’s installer fails with one of those errors.

File Explorer Visual C++ runtime error

Fix File Explorer Visual C++ Runtime Error.cmd fixes a blank Microsoft Visual C++ Runtime Library error from File Explorer. It removes a search setting that older Atlas releases left behind, then restarts File Explorer.

Safe Mode

9. Troubleshooting then Safe Mode sets how Windows starts next time:

  • Safe Mode.cmd starts Windows with only essential drivers and services.
  • Safe Mode with Networking.cmd adds network access.
  • Safe Mode with Command Prompt.cmd starts to a command prompt instead of the desktop.
  • Exit Safe Mode.cmd returns to a normal start.

Each file recommends a restart. Windows keeps starting in Safe Mode until you run Exit Safe Mode.cmd, so run it from Safe Mode when you’ve finished.

Services

Set services to defaults.cmd restores the startup settings of the services Atlas manages to Atlas’s defaults. Try it if a Windows feature stopped working after you changed services yourself. Restart when it asks.

Telemetry Components

Telemetry Components.cmd adds or removes Atlas’s NoTelemetry package, which removes some Windows telemetry components. It asks which you want, then asks you to restart.

Removing the package restores those components, which can help when you’re tracking down a problem. If that fixes it, report it so the Atlas team can look into it. Atlas’s policies that turn off telemetry stay in place either way.

Reset this PC

Atlas doesn’t support Reset this PC. It can’t reliably return a PC with Atlas to standard Windows. Reset this PC (read first).url opens Reverting Atlas, which explains how to reinstall Windows instead.

Still stuck?

If these tools don’t solve the problem, report it. In Atlas Manager, Send a report sends it privately to the Atlas team, and Export diagnostics creates a ZIP to share when you ask for help.

Export diagnostics before you reinstall Windows or delete anything. The ZIP keeps the logs the Atlas team needs to find the cause.

Search documentation

Search the docs

Pages, guides, and reference