Salad logoSalad logo
Salad logoSalad logo
Quickstart
Troubleshooting
Salad AppGeneral troubleshooting tips
Discord
TroubleshootingSalad App

General troubleshooting tips

The general checks that fix most unexplained Salad app problems, in order, and where to go when the app gives you a specific notification.

If the app shows a notification, follow its guide first - Degraded State lists every one. These general steps are for when the app misbehaves without saying why. Try Salad again after each.

Restart the app and the PC

Exit Salad from the tray icon (right-click > Exit), then restart Windows. A surprising amount is fixed here.

Confirm the PC meets the requirements

Is my machine compatible with Salad? - a dedicated GPU on the Network Monitor, enough RAM and free space on C:, virtualization enabled, no VPN.

Whitelist Salad in your antivirus and firewall

Antivirus guides. This covers the app, the container environment and the backup miners.

Update WSL and the container environment

In PowerShell as Administrator run wsl --update, then wsl --shutdown, then start Salad. If WSL itself is missing or broken: What is WSL?.

Close everything else

Salad needs the GPU to itself. Close games, local AI tools, overlays and capture software, and leave the PC idle. Close games and other programs.

Update, or clean-reinstall, your GPU driver

Many "random" failures are a damaged driver: How to reinstall your GPU drivers. If Salad stopped working right after a driver update, a clean install of the previous version is worth a try.

Update Windows and the Visual C++ runtime

Install pending Windows updates (Microsoft's guide) and the latest Visual C++ Redistributable, then reboot.

Last resort: reinstall Salad

Uninstall Salad, reboot, install from salad.com/download. Reinstalling doesn't touch drivers, WSL or Windows settings, which is why it comes last.

Still stuck?

Contact Salad Support with a description of what happens, your machine ID, and your logs folder zipped (how to find it). How to create a support ticket lists everything that speeds up an answer.

Edit on GitHub

Last updated on

Salad App

General troubleshooting for the Salad app when no other guide fits.

Degraded State

What the Degraded State notification in the Salad app means, how to read the error code, and which guide fixes each one.

On this page

Restart the app and the PCConfirm the PC meets the requirementsWhitelist Salad in your antivirus and firewallUpdate WSL and the container environmentClose everything elseUpdate, or clean-reinstall, your GPU driverUpdate Windows and the Visual C++ runtimeLast resort: reinstall SaladStill stuck?