---
updatedAt: 2026-03-01T18:39:48.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/eaa/llms.txt
---

# Troubleshoot EAA Client

For any issues with EAA Client, copy [the user name, EAA Client version, OS version, IdP name](https://techdocs.akamai.com/eaa/docs/eaa-client-op) and save [logs after you set the verbosity to high](https://techdocs.akamai.com/eaa/docs/eaa-client-op). Next, [contact support](https://www.akamai.com/global-services/support).

# Troubleshoot port conflict error

Debug port conflict error. When an application on a computer uses a local port, and a client-access tcp-type application also uses the same port, there is a port conflict. When you run diagnostics, you get the port conflict error:

```
Configuration is invalid or has a port conflict
Synchronize your configuration again or contact your administrator 
```

To resolve the issue, [perform sync](https://techdocs.akamai.com/eaa/docs/eaa-client-op). If the error still persists, you have a port conflict. To debug further, contact [support](https://www.akamai.com/global-services/support).

# Troubleshoot stuck in connecting state

If you installed and configured the EAA Client, but the EAA Client icon remains in **trying to connect** state ![](https://techdocs.akamai.com/eaa/img/eaa-client-icon10-connect-v1.png) run [diagnostics](https://techdocs.akamai.com/eaa/docs/eaa-client-op) and check there is network connectivity. If you have network connectivity, and if the network type is **Captive portal**, authenticate with [the captive portal web page](https://techdocs.akamai.com/eaa/docs/captive-portal-support). The EAA Client icon should change to **connected** state. If it remains in connecting state, run diagnostics again, and [contact support](https://www.akamai.com/global-services/support).

# Troubleshoot stuck in connecting state after MacOS upgrade

With the upgrade the MacOS the EAA Client icon changes to **trying to connect** state ![](https://techdocs.akamai.com/eaa/img/eaa-client-icon10-connect-v1.png) and remains in this state. This happens because the tunnel may not be configured properly. To troubleshoot open the Terminal and run the command:

```
sudo launchctl load -w /Library/LaunchDaemons/net.eaacloop.wapptunneld.plist
```

Next, reboot the computer. EAA Client should launch properly and the EAA Client icon should change to **connected** state.

# Troubleshoot websocket handshake failure

The EAA Client uses websockets to securely communicate with the Enterprise Application Access Cloud. Users who have problems with EAA Client use, can set high verbosity level in EAA Client and check for alerts in EAA Client. If they get `Websocket handshake failed` message, they should inform you about it. To troubleshoot it, [contact support](https://www.akamai.com/global-services/support).

# Troubleshoot unexpected logout

When you block users from accessing client applications, their EAA Client goes from **connected** state to **not connected** state (unexpectedly for these users). If the unexpected state change happens to a user who is not blocked by you they should [contact support](https://www.akamai.com/global-services/support).

# Restart EAA Client from a sleep mode

If your device goes to sleep, the EAA Client automatically logs you out of the identity provider (IdP) portal page. When you log in again, the EAA Client goes from the **not connected** state to the **connected** state. It can take up to 30 seconds.

If authorization does not run automatically, log in through the [EAA Client settings](https://techdocs.akamai.com/eaa/docs/eaa-client-op) or login from [EAA contextual menu](https://techdocs.akamai.com/eaa/docs/use-eaa-client). This authenticates  the user again and the `authentication succeeded` message appears.

# Troubleshoot connector health issues

Check the health of the connector you use for your applications on the connector card. The EAA connector card helps you troubleshoot the connector issues, and directly access applications, directories associated with the connector. If your connector has high load, you can improve the connector health by reducing the load.

# Troubleshoot application access, ACL, and network connectivity issues

Use [User diagnostics portal](https://techdocs.akamai.com/eaa/docs/user-diagnostics-portal) to troubleshoot user application access issues, ACL and authorization violation issues, and network connectivity issues.

# Sibling pages

* [EAA Status Page](https://techdocs.akamai.com/eaa/docs/eaa-status-page.md)
* [User Diagnostics portal](https://techdocs.akamai.com/eaa/docs/user-diagnostics-portal.md)
* [Troubleshoot EAA](https://techdocs.akamai.com/eaa/docs/trbl.md)
* [Troubleshoot Device Posture](https://techdocs.akamai.com/eaa/docs/trbl-dp.md)
* [Contact support](https://techdocs.akamai.com/eaa/docs/contact-support.md)