Troubleshooting Salad App Connection Issues
Salad does not offer support for Chefs running Salad in Virtual Machines (VMWare, VirtualBox, Proxmox, etc), which can cause Salad to stop working properly - our support team will not help investigate issues.
Most Remote Desktops relying on RDP will cause the above issue - please uninstall these from your system and reinstall Salad should you encounter this issue.
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 "Quit Salad"
-
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$
Get in Touch with Support
If your connection issues persist, please reach out to Salad Support, and our team will get back to you as soon as possible.
Last updated on