Troubleshoot connection issues

If you’re having trouble connecting to Slack on the desktop app or in a browser, learn more about connection issues and how to troubleshoot.

Tip: If you’re an IT or a network admin, learn how to manage connection issues for your network.

 

Common issues

Issue

Error

Connectivity failure

Slack cannot connect

Loading trouble

For some reason, Slack couldn’t load.

Server error

Sorry! Something went wrong, but we’re looking into it.

WebSocket trouble

Last updated less than a minute ago… (error will appear in a grey banner)

Browser errors

You'll see an error message in the browser you’re using to access Slack.

 

Connectivity failure

The issue 

The Slack desktop app isn’t connecting and you see an error code such as -106:ERR_INTERNET_DISCONNECTED.

Screenshot of an error message that reads Slack cannot connect

 

Steps to troubleshoot

Step 1: Clear the cache and restart Slack

  1. Click the Clear Cache and Restart button below the error code.
  2. Restart your device.


Step 2: Locate your error code for additional troubleshooting

Find the error code you’re seeing in the table below for additional troubleshooting steps. If you’re working with your network administrator, provide them with the error details you’re seeing.

Tip: Some examples of security devices include a proxy, firewall, antivirus software, or VPN. To learn more, visit Manage Slack connection issues.

Error code

What to do next

ERR_ACCESS_DENIED
ERR_NETWORK_ACCESS_DENIED
ERR_BLOCKED_BY_CLIENT

Something’s preventing access to Slack on your side. Check the settings on any security devices you’re using to ensure they allow access to Slack.

ERR_CONNECTION_CLOSED

Connections are being closed on your side. Check the settings on any security devices you’re using to ensure they allow access to Slack.

ERR_CONNECTION_RESET

Connections are being reset on your side. Check the settings on any security devices you’re using to ensure they allow access to Slack. 

ERR_ADDRESS_UNREACHABLE
ERR_CONNECTION_TIMED_OUT

You're unable to reach an IP address (or more than one) in order to connect to Slack. Check the settings on any security devices you’re using to ensure they allow access to Slack.

ERR_NAME_NOT_RESOLVED
ERR_NAME_RESOLUTION_FAILED

Your device is unable to resolve a domain to an IP address (e.g., your device needs to know the IP addresses for Slack domains, such as app.slack.com, in order to connect to Slack's servers).

ERR_TUNNEL_CONNECTION_FAILED
ERR_PROXY_CONNECTION_FAILED

A connection cannot be made to your proxy. Reach out to the team who manages your proxy and ensure they allow access to Slack.

ERR_INTERNET_DISCONNECTED

You’re not connected to the internet. Try turning the internet settings on your device off and on.


Step 3: Collect and send us your Net Logs

If you’re still having trouble, collect and send us your Net Logs so we can investigate further. You can collect Net Logs from either the desktop app or Google Chrome, depending on which you’re using when the issue occurs. If you’re having trouble with both the desktop app and browser, use the steps below for the desktop app.

Desktop app

Google Chrome

  1. Open the Slack desktop app, then click Help in your computer's top menu bar. (If you’re on Windows 10, click the ☰ three lines icon in the top left of the Slack app.)
  2. Select Troubleshooting, then Restart and Collect Net Logs. The app will restart. Once it does, you’ll see a pop-up window with the message Your log is in progress.
  3. Use Slack as you usually would. When the issue occurs, go back to the pop-up window and click Stop Logging.
  4. Locate the zip file in the Downloads folder on your computer.
  5. Send us a note with the file attached.
  1. Open Google Chrome and go to the following link: chrome://net-export/.
  2. Click Start Logging to Disk.
  3. Save the file as slackNetlog.
  4. Open a new tab in Google Chrome, then open your Slack workspace.
  5. Use Slack as you usually would. When the issue occurs, go back to the chrome://net-export/ tab, and click Stop Logging.
  6. Locate the slackNetlog file in the Downloads folder on your computer.
  7. Send us a note with the file attached.

Note: If you're using a browser that isn’t Google Chrome, send us a note and we'll help you troubleshoot further.

 


Loading trouble

The issue 

Slack is having trouble loading on the desktop app or browser. When this happens, browser extensions or a security device may be interfering, or there could be an issue on Slack’s end.

Screenshot of an error message that reads For some reason, Slack couldn't load.

Steps to troubleshoot

Step 1: Clear your cache 

Desktop

Browser

  1. Open the Slack desktop app, then click Help in your computer's top menu bar. (If you’re on Windows 10, click the ☰ three lines icon in the top left of the Slack app.)
  2. Select Troubleshooting.
  3. Click Clear Cache and Restart.
  1. Clear your web browser's cache. These steps will vary depending on which browser you're using.
  2. Open Slack in a private or in an Incognito window. If you can connect to Slack, the issue may be due to a browser extension. Disable any browser extensions to see if this allows Slack to load in a normal browser window.


Step 2: Run the Slack connection test

  1. Visit slack.com/help/test to check your connection to Slack.
  2. If there are any errors, contact a network administrator.


Step 3: Collect and send us your Net Logs

If you’re still having trouble, collect and send us your Net Logs so we can investigate further. You can collect Net Logs from either the desktop app or Google Chrome, depending on which you’re using when the issue occurs. If you’re having trouble with both the desktop app and browser, use the steps below for the desktop app.

Desktop app

Google Chrome

  1. Open the Slack desktop app, then click Help in your computer's top menu bar. (If you’re on Windows 10, click the ☰ three lines icon in the top left of the Slack app.)
  2. Select Troubleshooting, then Restart and Collect Net Logs. The app will restart. Once it does, you’ll see a pop-up window with the message Your log is in progress.
  3. Use Slack as you usually would. When the issue occurs, go back to the pop-up window and click Stop Logging.
  4. Locate the zip file in the Downloads folder on your computer.
  5. Send us a note with the file attached.
  1. Open Google Chrome and go to the following link: chrome://net-export/.
  2. Click Start Logging to Disk.
  3. Save the file as slackNetlog.
  4. Open a new tab in Google Chrome, then open your Slack workspace.
  5. Use Slack as you usually would. When the issue occurs, go back to the chrome://net-export/ tab, and click Stop Logging.
  6. Locate the slackNetlog file in the Downloads folder on your computer.
  7. Send us a note with the file attached.

Note: If you're using a browser that isn’t Google Chrome, send us a note and we'll help you troubleshoot further.

 

Server error

The issue 

An error with Slack’s server may be preventing the desktop app or browser from connecting and loading.

servor_error.png

Steps to troubleshoot

Step 1: Reload Slack

  1. Open Slack from the desktop app or a browser.
  2. Use R (Mac) or CtrlR (Windows/Linux).


Step 2: Contact us

If you're still having trouble, visit the Slack Status site to see whether there are any issues we're currently working to resolve. If that's not the case, get in touch with us as there may be an issue on Slack’s end. 

 

WebSocket trouble

The issue 

When Slack is having trouble maintaining WebSocket connections on the desktop app or a browser, you won’t receive any new messages from your channels or direct messages as they’re sent.

websocket.png

Steps to troubleshoot

Step 1: Contact your network administrator

Get in touch with your network administrator to ensure WebSocket connections are supported. In addition, ask them to inspect any connection attempts to the following domains:

  • wss-primary.slack.com
  • wss-backup.slack.com
  • wss-mobile.slack.com


Step 2: Collect and send us your Net Logs

If you’re still having trouble, collect and send us your Net Logs so we can investigate further. You can collect Net Logs from either the desktop app or Google Chrome, depending on which you’re using when the issue occurs. If you’re having trouble with both the desktop app and browser, use the steps below for the desktop app.

Desktop app

Google Chrome

  1. Open the Slack desktop, then click Help in your computer's top menu bar. (If you’re on Windows 10, click the ☰ three lines icon in the top left of the Slack app.)
  2. Select Troubleshooting, then Restart and Collect Net Logs. The app will restart. Once it does, you’ll see a pop-up window with the message Your log is in progress.
  3. Use Slack as you usually would. When the issue occurs, go back to the pop-up window and click Stop Logging.
  4. Locate the zip file in the Downloads folder on your computer.
  5. Send us a note with the file attached.
  1. Open Google Chrome and go to the following link: chrome://net-export/.
  2. Click Start Logging to Disk.
  3. Save the file as slackNetlog.
  4. Open a new tab in Google Chrome, then open your Slack workspace.
  5. Use Slack as you usually would. When the issue occurs, go back to the chrome://net-export/ tab, and click Stop Logging.
  6. Locate the slackNetlog file in the Downloads folder on your computer.
  7. Send us a note with the file attached.

Note: If you're using a browser that isn’t Google Chrome, send us a note and we'll help you troubleshoot further.

 

Browser errors

The issue 

You’re seeing an error with the browser you’re using to access Slack. Here’s an example from Google Chrome:

google_chrome_error.png

Steps to troubleshoot

  1. If applicable, use the troubleshooting steps included in your browser’s error message.
  2. Make sure the browser you're using is supported and up to date. Visit Minimum requirements for using Slack for more details.
  3. Clear your web browser's cache (these steps will vary depending on the browser you're using).
  4. Open Slack in a private or in an Incognito window to see if you can connect to Slack. If you can connect in a private or an Incognito window, the issue may be due to a browser extension. Disable any browser extensions to see if this allows Slack to load in a normal browser window.
  5. Reach out to your network administrator.
  6. Contact us if you need further assistance.