Knowledge Base
Find answers, documentation and guides for Viscosity.
Documentation
- Getting Started With Viscosity (Mac)
- Getting Started With Viscosity (Windows)
- Using Viscosity
- VPN Service Providers
- Advanced Configuration Commands
- Connection Settings
- Installing Viscosity (Mac)
- Installing Viscosity (Windows)
- Introduction To VPNs
- Ovpngen: OpenVPN Configuration Generator
- Security of Updates & Outbound Connections
- SparkLabs Security Documentation
Common Questions
- Can I use both iCloud Private Relay and Viscosity?
- Community Contributions
- How Do I Find Out Who My VPN Provider Is?
- How Do I Transition to Viscosity from Tunnelblick?
- How Do I Transition to Viscosity from Windows OpenVPN GUI?
- How Do I Use Time Machine Through a VPN Connection?
- Why Do My VPN Connections Disconnect On Sleep?
Features
- Configuring DNS and WINS settings
- Routing Traffic For Websites & Applications
- Conditional Connections
- Controlling Viscosity with AppleScript (Mac)
- Controlling Viscosity with Scripting (Windows)
- Managing and Deleting Saved Credentials
- Preventing Network and DNS Traffic Leaks
- Running AppleScripts When Connected/Disconnected
- Running Batch/VBS Scripts when Connected/Disconnected
- Sharing Credentials and Scripts with Multiple Connections
- Single Adapter Mode (Windows)
- Using macOS Keychain Certificates and Identities for OpenVPN Connections
- Using Multiple VPN Connections Simultaneously
- Using Tokens/Smartcards (PKCS#11)
- Web Authentication (SSO/SAML) with OpenVPN and Viscosity
Purchasing & Registering Viscosity
- License Email Has Not Arrived
- License Details Are Not Accepted
- Downloading An Invoice
- Educational Pricing
- Information for Software Resellers
- Invoice Payments Via Check or Bank Transfer
- License Upgrades and Volume Extensions
- Purchasing Viscosity
- Refund Requests
- Registering Viscosity
- Resending License Details
- Retrieving Your Receipt Or Transaction Number
- Student and Staff Educational Discount
- Updating License Contact Details
- Using Your License On Multiple Computers
- Viscosity License Inclusions
Enterprise
- Common Deployment and Management Questions
- Bundling Viscosity with VPN Connections & Preferences (Mac)
- Bundling Viscosity with VPN Connections & Preferences (Windows)
- Deploy Viscosity Windows under a GPO Group Policy Environment
- Deploying Viscosity on macOS using Jamf Now
- Deploying Viscosity on macOS using Munki
- Exporting and Distributing Connections
- Integrating Viscosity with Custom Update Tools
- License Types
Troubleshooting
- Troubleshooting Connection Problems
- Backing up Viscosity's Settings
- Logs and Information to Provide Support Staff
- Losing Network Connectivity Once Disconnected
- Migrating from OpenVPN 2.3 to OpenVPN 2.4
- Migrating from OpenVPN 2.4 to OpenVPN 2.5
- Migrating from OpenVPN 2.5 to OpenVPN 2.6
- Problem Saving Details Into The Keychain
- Troubleshooting DNS Problems
- Troubleshooting Viscosity Problems (Mac)
- Troubleshooting Viscosity Problems (Windows)
- Uninstalling Viscosity (Mac)
- Uninstalling Viscosity (Windows)
- Using Viscosity Beta Versions
- Viewing the Connection Log
- Viewing the Console Log
- Viewing the Event Viewer
Common OpenVPN Errors
- Error: AUTH: Received control message: AUTH_FAILED
- Error: Cannot load certificate file cert.crt
- Error: Connection Name Could Not Be Connected
- Error: Inactivity timeout (--ping-restart)
- Error: Insecure Signature Digest Detected
- Error: Private key password verification failed
- Error: Server Cipher Negotiation Not Supported
- Error: Server Encryption Cipher Disallowed
- Error: Socket bind failed on local address
- Error: TCP: connect to address failed, will try again in 5 seconds
- Error: The command "auth-federate" or one of its parameters is invalid
- Error: TLS Error: TLS key negotiation failed to occur within 60 seconds
- Error: Unsafe OpenVPN command detected
- Error: Unsupported TLS Protocol Detected
- Error: Viscosity Helper Tool Disabled
- Error: write to TUN/TAP : Input/output error (code=5)
- Error: You must define CA file (--ca) or PKCS#12 file (--pkcs12)
- Note: Unable to redirect IPv4 default gateway: VPN gateway parameter is missing
- Time Machine Backups Could Not Be Disabled
- Warning: A connection reset occurred with a legacy cipher command present
- Warning: Bad compression stub decompression header byte
- Warning: Split DNS is being used however no DNS domains are present
- Warning: The block-outside-dns option has been ignored
Two-Factor Authentication Setup Guides
VPN Server Setup Guides
- Creating Certificates and Keys for your OpenVPN Server
- Introduction to Running an OpenVPN Server
- Setting up an Obfuscation server with Obfsproxy and Viscosity
- Setting up an OpenVPN server with DD-WRT and Viscosity
- Setting up an OpenVPN server with Netgear and Viscosity
- Setting up an OpenVPN server with Okta Single Sign-on Web Authentication and Viscosity
- Setting up an OpenVPN server with OPNsense and Viscosity
- Setting up an OpenVPN server with pfSense and Viscosity
- Setting up an OpenVPN server with RCDevs WebADM, U2F and Viscosity
- Setting up an OpenVPN server with Red Hat Linux and Viscosity
- Setting up an OpenVPN server with Sophos UTM and Viscosity
- Setting up an OpenVPN server with Sophos XG and Viscosity
- Setting up an OpenVPN server with Synology and Viscosity
- Setting up an OpenVPN server with Tomato router and Viscosity
- Setting up an OpenVPN server with Ubuntu
- Setting up an OpenVPN server with VyOS and Viscosity