AWS Client VPN for macOS

The following procedure shows how to establish a VPN connection using the AWS provided client for macOS. You can download and install the client at AWS Client VPN download. The AWS provided client does not support automatic updates.

Requirements

To use the AWS provided client for macOS, the following is required:

• macOS Monterey (12.0), Ventura (13.0), or Sonoma (14.0).

• x86_64 processor compatible.

• The client reserves TCP port 8096 on your computer.

• For Client VPN endpoints that use SAML-based federated authentication (single sign-on), the client reserves TCP port 35001.

Note

If you are using Mac with Apple silicon processor, you will need to install Rosetta 2 to run the client software. For further details, see About the Rosetta Translation Environment on Apple's website.

Connecting

Before you begin, ensure that your Client VPN administrator has created a Client VPN endpoint and provided you with the Client VPN endpoint configuration file.

Also, ensure that you've read the requirements. The AWS provided client is also referred to as the AWS VPN Client in the following steps.

To connect using the AWS provided client for macOS

1. Open the AWS VPN Client app.

2. Choose File, Manage Profiles.

   

3. Choose Add Profile.

4. For Display Name, enter a name for the profile.

   

5. For VPN Configuration File, browse to the configuration file that you received from your Client VPN administrator. Choose Open.

6. Choose Add Profile.

7. In the AWS VPN Client window, ensure that your profile is selected and then choose Connect. If the Client VPN endpoint has been configured to use credential-based authentication, you'll be prompted to enter a user name and password.

8. To view statistics for your connection, choose Connection, Show Details.

   

9. To disconnect, in the AWS VPN Client window, choose Disconnect. Alternatively, choose the client icon on the menu bar, and then choose Disconnect <your-profile-name>.

   

Release notes

The following table contains the release notes and download links for the current and previous versions of AWS Client VPN for macOS.

Note

We continue to provide usability and security fixes with every release. We strongly recommend that you use the latest version for every platform. Previous versions may be affected by usability and/or security issues, see release notes for details.

Version	Changes	Date	Download link
3.10.0	Automatically reconnect when local area network ranges change. Fixed a DNS restoration issue during network switch. Removed automatic application focus when connected with SAML endpoints.	May 21, 2024	Download version 3.10.0 sha256: 28bf26fa134b01ff12703cf59fffa4adba7c44ceb793dce4addd4404e84287dd
3.9.2	Resolved a SAML authentication issue with Chromium-based browsers since version 123. Added support for macOS Sonoma. Deprecate support for macOS Big Sur. Improved security posture.	April 11, 2024	Download version 3.9.2 sha256: 374467d991e8953b5032e5b985cda80a0ea27fb5d5f23cf16c556a1568b0d480
3.9.1	Fixed a buffer overflow action that could potentially allow a local actor to execute arbitrary commands with elevated permissions. Fixed application update download progress bar. Improved security posture.	February 16, 2024	Download version 3.9.1 sha256: 9bba4b27a635e75038703e2cf4cd814aa75306179fac8e500e2c7af4e899e971
3.9.0	Fixed connectivity issues for some LAN configurations. Improved accessibility.	December 6, 2023	Download version 3.9.0 sha256: f0f6a5579fe9431577452e8aac07241c36cb34c2b3f028dfdd07f41d00ff80d8
3.8.0	Fixed a connectivity issue when NAT64 is enabled in the client network. Minor bug fixes and enhancements.	August 24, 2023	Download version 3.8.0 sha256: d5a229b12efa2e88627127a6dc27f5c6a1bc9c426a8c466131ecbdbd6bbb4461
3.7.0	Improved security posture.	August 3, 2023	Download version 3.7.0 sha256: 4a34b25b48233b02d6107638a3868f7e419a84d20bb4989f7b394aae9a9de00a
3.6.0	Improved security posture.	July 15, 2023	No longer supported
3.5.0	Rolled back changes from 3.4.0.	July 15, 2023	No longer supported
3.4.0	Improved security posture.	July 14, 2023	No longer supported
3.3.0	Added support for macOS Ventura (13.0). Minor bug fixes and enhancements.	April 27, 2023	No longer supported
3.2.0	Added support for "verify-x509-name" OpenVPN flag. Automatically detect when updated versions of the client are available. Added the ability to automatically install new client versions when available.	January 23, 2023	No longer supported
3.1.0	Added support for macOS Monterey. Fixed issue for drive type detection. Improved security posture.	May 23, 2022	No longer supported
3.0.0	Fixed the banner message not being displayed when using federated authentication. Fixed banner text display for longer text. Enhanced security posture.	March 3, 2022	No longer supported.
2.0.0	Added support for banner text after new connection is established. Removed ability to use pull-filter in relation to echo. i.e. pull-filter * echo Minor bug fixes and enhancements.	January 20, 2022	No longer supported.
1.4.0	Added DNS server monitoring during connection. Settings will be re-configured if they do not match VPN settings. Fixed federated authentication connection attempt in some cases. Minor bug fixes and enhancements.	November 9, 2021	No longer supported.
1.3.5	Added support for OpenVPN flags: connect-retry-max, dev-type, keepalive, ping, ping-restart, pull, rcvbuf, server-poll-timeout. Minor bug fixes and enhancements.	September 20, 2021	No longer supported.
1.3.4	Added support for OpenVPN flag: dhcp-option. Minor bug fixes and enhancements.	August 4, 2021	No longer supported.
1.3.3	Added support for OpenVPN flags: inactive, pull-filter, route. Fixed an issue with configuration filenames with spaces or Unicode. Fixed an issue that caused app crashes on disconnect or exit. Fixed an issue with Active Directory usernames with backslash. Fixed app crash when manipulating profile list outside of app. Minor bug fixes and enhancements.	July 1, 2021	No longer supported.
1.3.2	Add IPv6 leak prevention, when it is configured. Fixed a potential crash when you use the Show Details option under Connection. Add daemon log rotation.	May 12, 2021	No longer supported.
1.3.1	Added support for macOS Big Sur (10.16). Fixed issue that removed DNS settings configured by other applications. Fixed issue when using a non-valid certificate for mutual authentication causing connectivity issues. Added support for 'route-ipv6' OpenVPN directive. Minor bug fixes and enhancements.	April 5, 2021	No longer supported.
1.3.0	Added support features such as error reporting, sending diagnostic logs, and analytics.	March 8, 2021	No longer supported.
1.2.5	Minor bug fixes and enhancements.	February 25, 2021	No longer supported.
1.2.4	Minor bug fixes and enhancements.	October 26, 2020	No longer supported.
1.2.3	Added support for comments in the OpenVPN configuration. Added an error message for TLS handshake errors. Fixed an uninstall bug that was affecting some users.	October 8, 2020	No longer supported.
1.2.2	Minor bug fixes and enhancements.	August 12, 2020	No longer supported.
1.2.1	Added support for uninstalling application. Minor bug fixes and enhancements.	July 1, 2020	No longer supported.
1.2.0	Added support for SAML 2.0-based federated authentication. Added support for macOS Catalina (10.15).	May 19, 2020	No longer supported.
1.1.2	Minor bug fixes and enhancements.	April 21, 2020	No longer supported.
1.1.1	Fixed issue where DNS was not resolving. Fixed an app crash issue caused by longer connections. Fixed an MFA issue.	April 2, 2020	No longer supported.
1.1.0	Added support for macOS DNS configuration. Added support for OpenVPN static challenge echo functionality to hide or show the text displayed in the user interface. Minor bug fixes and enhancements.	March 9, 2020	No longer supported.
1.0.0	The initial release.	February 4, 2020	No longer supported.