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.