---
title: 'Tutorial: Configure a Ubiquiti (EdgeMAX) Router to Connect to CloudConnexa'
canonical: https://openvpn.net/cloud-docs/tutorials/configuration-tutorials/connectors/routers/tutorial--configure-a-ubiquiti--edgemax--router-to-connect-to-cloudconnexa/
product: CloudConnexa Docs
description: Step-by-step instructions for configuring a Ubiquiti EdgeMAX router to connect to CloudConnexa as a Network Connector using an OpenVPN profile.
keywords: Ubiquiti (EdgeMAX)
---

# Tutorial: Configure a Ubiquiti (EdgeMAX) Router to Connect to CloudConnexa

## Introduction

This tutorial explains how to configure a Ubiquiti EdgeMAX router as a CloudConnexa Network Connector. After completing these steps, devices and subnets behind the router can securely communicate with resources in your CloudConnexa private network (WPC) without requiring VPN client software on individual devices.

You will:

- Download a Network Connector connection profile from CloudConnexa.
- Configure the profile on the EdgeMAX router using SSH and the EdgeMAX CLI.
- Route traffic between your local network and your CloudConnexa WPC.

This setup is useful for connecting branch offices, lab environments, or remote networks to CloudConnexa through a site-to-site style deployment.

> **Note**
>
> Your router needs to be running EdgeRouter X v2.0 or newer.

## Before you begin

- You have a CloudConnexa account and can sign in to the Administration portal.
- You have SCP access to the router from your local computer.
- You have SSH access to the router.

## Step 1: Create a Network in CloudConnexa

1. Sign in to your WPC's Administration Portal at your **Cloud ID** address (for example, `yourcompany.openvpn.com`).
2. Navigate to **Networks → Networks**.
3. Select **Add Network**.
4. Select at least one **Network Scenario**, and select **Continue**. Refer to [Add a Network](https://openvpn.net/cloud-docs/owner/networks/networks---networks/add-a-network-for-remote-access-using-the-network-wizard.md) for details.
5. Enter a **Network name** and optional description.
6. Leave the **Connector Tunneling Protocol** set to the default (**OpenVPN**).
7. Under **Connector**, enter a name, an optional description, and select a region.
8. Select **Next**.

## Step 2: Deploy the Connector and download a connection profile

In the **Deploy Network Connector** step:

1. Select **Ubiquiti** from the **Provider Type** drop-down menu.
2. Select **Download OVPN Profile** to download the connection profile to your local computer.
3. Select **Next**.
   - CloudConnexa displays the Connector status. The Connector will show as **Offline** until the router is configured and connects in the following steps.

## Step 3: Configure routing

1. Review the allocated **WPC Subnets**, **Domain Routing Subnets**, and routes of other connected networks displayed by CloudConnexa. Note any values you will need when configuring static routes on your router.
2. Optionally, you can add applications or IP services in the next wizard configuration steps.
3. Select **Finish**.

## Step 4: Copy the connection profile to the router

1. Open a terminal on your local computer.
2. Run the following command to upload the connection profile to the router's `/config/auth/` directory:

   ```
   scp /path/to/Profile.ovpn admin@<router_ip_address>:/config/auth/
   ```

   Replace `/path/to/Profile.ovpn` with the absolute path to the downloaded file.

   Replace `<router_ip_address>` with the external IP address of your router.

## Step 5: Create the OpenVPN interface

1. Connect to the router via SSH:

   ```
   ssh admin@<router_ip_address>
   ```
2. Enter configuration mode:

   ```
   configure
   ```
3. Create a new OpenVPN tunnel interface pointing to the connection profile:

   ```
   set interfaces openvpn vtun0 config-file /config/auth/Profile.ovpn
   set interfaces openvpn vtun0 description "CloudConnexa Connector"
   ```
4. Commit and save your changes, then exit configuration mode:

   ```
   commit
   save
   exit
   ```

   > **Note**
   >
   > The OpenVPN tunnel interface name must follow the format `vtun<num>` (for example, `vtun0`). Replace `Profile.ovpn` with the actual filename of your downloaded connection profile.

## Step 6: Verify the connection

1. Connect to the router through HTTPS.
2. Navigate to the **Dashboard** tab.
3. Confirm that your newly created interface exists with:
   - **Interface type:** `openvpn`
   - **Status:** Connected
   - An assigned IP address
4. In the CloudConnexa Administration portal, navigate to **Networks → Connectors** and confirm the Connector status is **Connected**.

---

Prev: [Tutorial: Configure a Teltonika Router To Connect to CloudConnexa](https://openvpn.net/cloud-docs/tutorials/configuration-tutorials/connectors/routers/tutorial--configure-a-teltonika-router-to-connect-to-cloudconnexa.md)
Next: [Tutorial: Configure a Ubiquiti (UniFi) Router to Connect to CloudConnexa](https://openvpn.net/cloud-docs/tutorials/configuration-tutorials/connectors/routers/tutorial--configure-a-ubiquiti--unifi--router-to-connect-to-cloudconnexa.md)
Index: https://openvpn.net/cloud-docs/llms.txt