Trouble connecting to the Salad app
Fix the Salad app stuck on Connecting or a login that never completes - supported browsers, Chrome's local network permission, restarts, DNS sinkholes and VPNs.
The app signs in through your web browser: it opens the Salad login page, and once you're logged in there the browser hands the session back to the app. "Connecting" that never finishes means that hand-off failed. Work through the sections in order; the first two fix most cases.
Virtual machines and Remote Desktop
Salad isn't supported inside virtual machines (VMware, VirtualBox, Proxmox and similar) and support can't investigate issues there. Windows Remote Desktop and other RDP tools usually also break the app, because they replace the desktop session - use a mirroring tool instead, see Using remote desktop with Salad.
Before anything else: VPNs, proxies and antivirus
Disconnect any VPN or proxy and pause your antivirus's web protection, then try again. The app can't connect through a VPN, and several security products block the browser-to-app hand-off. If that fixes it, whitelist Salad (antivirus guides).
Use a Supported Web Browser
Ensure that the web browser you're using is supported by Salad. Some supported browsers include:
Some browsers have protection settings enabled which conflict with Salad, some popular examples include:
- Brave Browser
- Safari
These, along with other privacy-centric browsers may pose similar problems.
Selecting a Supported Web Browser
-
Find your Salad Widget in the System Tray or Overflow Tray

-
Click the Salad Widget icon and open the Salad Widget Menu at the top left

-
Click 'Account' within the Salad Widget Menu, you should be redirected to the Salad Account Summary web browser page, within your default web browser.

-
From here, you have two options:
- If your device's default web browser is unsupported by Salad, simply copy and paste the URL above into a supported web browser, such as Google Chrome, Firefox, or Microsoft Edge.
- You can also temporarily, or permanently, change your device's default web browser to a supported web browser. This will change where the Salad Account URL redirects to by default. Here's more on how to change your default web browser:
Try Restarting the Salad App and/or Your Machine(s)
Sometimes a simple restart can solve common connection issues. Please try these troubleshooting steps:
Restart your Salad App:
-
Open the Windows System Tray or Overflow Tray and find the Salad Widget icon

-
Right click the Salad Widget icon, then click "Exit"

-
Search for Salad in your Windows Search Bar

-
Find the Salad App and click it to restart Salad. If the connection was successful your Salad Widget should automatically open.

Restart your Machine
Simply follow these instructions for safely restarting a Windows machine:
Using a recent version of Chrome?
Newer versions of Chrome now require an extra permission in order to finalize the login process. After installing Salad on your machine and logging in (or signing up), you may remain stuck on the following screen:

In order to continue with the login process and ensure the app itself is logged in, you will need to allow "Local network access" to the site. In some cases, this option will be requested from you, and you should click "Allow" to authorize the login process, like so:

Should the browser not display this tooltip, you can also manually authorize it by:
- In the top left, next to the URL, click the "toggle" symbol
- Then, towards the bottom of the tooltip, click "Site Settings"

- At the "Privacy and Security" page (which you should be automatically redirected to), scroll to the bottom until you find the "Local network access" permission, and set it to "Allow"

- You can then go back to the previous page (the Salad login page), and reload the tab

- After the tab finishes to reload, the login process should now continue successfully
Why does Salad need this permission?
When you press the login button in the app, Salad sends a request to your browser to start the login process, and then waits for confirmation from the browser that you are logged in to receive the account information. Any access required by a website to a local machine (including to services running directly on your machine - like Salad) now need to be approved via this permission. Salad only uses this permission to complete the login process, and does not actively access other machines or services on your machine.
If you are not comfortable with keeping this option in an allowed state, you can also set it to blocked (or Ask) once the login process has ended - in which case you will need to repeat this process the next time the app requests you to log in.
Using Pihole or other DNS Sinkholes?
If you are using a DNS Sinkhole - such as pihole - in your home network, certain blocklists - especially restrictive ones - can prevent access to Salad Servers.
As such, it is recommended to review your DNS sinkhole settings to either remove problematic blocklists, or add an exception for Salad services by using regex rules in the form:
(\.|^)salad\.com$(\.|^)salad\.io$
Check the date and time
A PC clock that's wrong by more than a few minutes makes the secure connection fail. See Correct system time error.
Still stuck?
Send Salad Support which browser you use, whether a VPN or security product is installed, and your logs folder zipped (how to find it). If support asks for a HAR file of the login attempt, see How to create a HAR file.
Last updated on
Connection & Login
The app stuck on "Connecting", login codes that never arrive, passkey problems, and ISP or DNS setups that block Salad.
I can't enter my email address to log in
What to do when the login page won't accept your email or says the one-time code email couldn't be sent: a full inbox, a spam blocklist, or an unsubscribe on your address.

