Handshake & Session Setup Errors

 ← Back to Error Codes 

Overview

Handshake & Session Setup Errors occur when the Softdrive client and the remote Cloud PC are unable to successfully negotiate the parameters required to establish or maintain a session.

These errors typically happen after the initial connection attempt but before the session is fully established, secured, or stabilized.

Most handshake and session setup issues are related to network quality, security policies, or real-time traffic reliability.

Common Characteristics

Handshake and session setup errors often share the following traits:

• The client can reach the remote PC or Softdrive services

• The connection fails during negotiation or configuration

• Retrying may temporarily succeed if network conditions improve

Common Causes

These errors are usually caused by one or more of the following:

• Poor or unstable internet connection

• Packet loss, jitter, or high latency

• Firewalls, VPNs, or security tools interfering with traffic

• SSL/TLS inspection or traffic shaping

• Blocked, throttled, or one-way UDP traffic

These issues are network-related and are not typically caused by the Cloud PC itself.

Related Error Codes

The following error codes fall under handshake and session setup failures:

• Error Code 01 – TLSHandshakeFailed
  Secure TLS handshake could not be completed.

• Error Code 02 – TLSHandshakeTimeout TLS handshake timed out during secure connection setup.

• Error Code 03 – HandshakeTimeout Session settings acknowledgment (ACK) was never received.

• Error Code 04 – KeepAliveTimeout UDP keepalive messages timed out after connection.

• Error Code 09 – SessionSettingsTimeout Server never received required session settings.

Troubleshooting

Things to do when encountering handshake or session setup errors:

• Check network quality
  Ensure a stable connection with low latency and packet loss. Wired connections are recommended.

• Try a different network
  Testing from a home network or mobile hotspot helps confirm whether the issue is network-related.

• Disable VPNs or security tools for testing
  Temporarily disable VPNs, SSL inspection, or traffic filtering to identify interference.

• Use the Troubleshoot option
  If Softdrive previously worked on the same network, use the Troubleshoot button in the dashboard.

If handshake or session setup errors persist across multiple networks, please contact Softdrive Support.

When opening a support ticket, include as much detail as possible:

• Error code(s) encountered

• Timestamp of the failure

• Network type (home, corporate, VPN, hotspot)

• Screenshots of the error messages

Email: support@softdrive.co

Providing network and session details allows the Softdrive team to quickly isolate handshake-related issues.