Connect to CloudRaya VPN on macOS

This guide explains how to connect a macOS device to CloudRaya VPN using L2TP over IPsec (PSK).

CloudRaya VPN allows you to securely access private IP resources inside your VPC, such as Virtual Machines, without exposing them to the public internet.

Before You Begin

Make sure you have the following information from the CloudRaya Control Panel:

• VPN Public IP
• Pre-Shared Key (PSK)
• VPN Username
• VPN Password

Requirements:

• At least one running VM in the selected location
• VPN status is Enabled
• macOS with administrator access
• Internet connection

Supported macOS Versions

This guide applies to:

• macOS Monterey
• macOS Ventura
• macOS Sonoma
• Newer macOS releases

macOS includes a built-in L2TP/IPsec VPN client. No additional software is required.

VPN Protocol Details

CloudRaya VPN uses:

• VPN Type: L2TP over IPsec
• IPsec Authentication: Pre-Shared Key (PSK)
• User Authentication: Username & Password
• PPP Authentication: MS-CHAP v2

Step 1: Open Network Settings

1. Open System Settings
2. Navigate to Network
3. Click Add VPN Configuration
4. Select L2TP over IPsec
5. Choose Create

Step 2: Configure VPN Connection

Fill in the VPN details:

• Display Name

  Example: CloudRaya VPN

• Server Address

  Enter your VPN Public IP

• Account Name

  Enter your VPN Username

Step 3: Configure Authentication Settings

Click Authentication Settings…

User Authentication

• Select Password
• Enter your VPN Password

Machine Authentication

• Select Shared Secret
• Enter the Pre-Shared Key (PSK)

Click OK to save.

Step 4: Apply and Save Configuration

1. Click Apply
2. Make sure the VPN configuration is enabled
3. Close Network Settings

Step 5: Connect to the VPN

1. Open System Settings → Network
2. Select CloudRaya VPN
3. Click Connect

Once connected, the VPN status will show Connected.

Verify the Connection

Check VPN Status

• The VPN icon appears in the menu bar
• Network settings show the VPN as active

Test Private IP Access

Open Terminal and run:

ping <PRIVATE_VM_IP>

If the ping succeeds, the VPN connection is working correctly.

Disconnect the VPN

To disconnect:

1. Open System Settings → Network
2. Select CloudRaya VPN
3. Click Disconnect

Common Issues and Troubleshooting

VPN Connects but Cannot Access Private IPs

• Ensure the VM is running
• Verify ACL rules allow internal traffic
• Confirm the VM is in the same VPC

Authentication Failed

• Recheck VPN username and password
• Ensure MS-CHAP v2 is enabled (default on macOS)
• Verify PSK is copied correctly

VPN Option Not Available

• Make sure L2TP over IPsec is selected
• macOS does not support L2TP via some MDM-restricted profiles

Important Notes

• VPN users can be reused across multiple VPCs
• VPN users cannot be used across different locations
• VPN provides private network access, not public internet routing
• VPN requires at least one active VM in the VPC to be available

Related Pages

📄 Manage VPN

📄 Connect to CloudRaya VPN on Windows

📄 Connect to CloudRaya VPN on Linux

📄 Virtual Private Cloud (VPC)