---
title: "Install cloudSwXtch BYOL on OCI"
slug: "install-cloudswxtch-oci-marketplace"
updated: 2026-01-16T15:38:10Z
published: 2026-01-16T15:38:10Z
canonical: "docs.swxtch.io/install-cloudswxtch-oci-marketplace"
stale: true
---
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swxtch.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Install cloudSwXtch via OCI Marketplace
WHAT TO EXPECT
In this article, users will learn how to deploy a cloudSwXtch instance via the Oracle Cloud Marketplace.
- [Step One: Navigate to cloudSwXtch in the Oracle Marketplace](/v2/docs/install-cloudswxtch-oci-marketplace#step-one-navigate-to-cloudswxtch-in-the-oracle-marketplace)
- [Step Two: Create Compute Instance](/v2/docs/install-cloudswxtch-oci-marketplace#step-two-create-compute-instance)
- [Step Three: Attach Secondary VNIC](/v2/docs/install-cloudswxtch-oci-marketplace#step-three-attach-a-secondary-vnic)
- [Optional Step for BYOL: Contact swXtch.io for License](/v2/docs/install-cloudswxtch-oci-marketplace#optional-step-for-byol-contact-swxtchio-for-a-license)
**Please note**: At this time, our only product offering in OCI is a BYOL instance of cloudSwXtch. This requires a user to contact swXtch.io for a license.
### Prerequisites
A user should have a **Compartment** established in their Oracle Cloud console before they start to deploy a cloudSwXtch. For more information about compartments, please see the [Managing Compartments](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm) page under Oracle Cloud Infrastructure Documentation.
### Step One: Navigate to cloudSwXtch in the Oracle Marketplace
1. Log in to **Oracle Cloud**.
2. Navigate to the **Oracle Cloud Marketplace** using the **Navigation** menu at the top left corner.
3. Select **Marketplace** and **All Applications**.
4. Search for **cloudSwXtch** and select the product, **cloudSwXtch BYOL**.
5. Select the **Version** and the **Compartment**. It is best to use the default since it will be the most recent version.
6. Click **Launch Instance**.
### Step Two: Create Compute Instance
- Give the Compute Instance a unique name.
- Confirm that the Compartment is populated.
- Optional: Edit selections for Placement and Security. This is dependent on a user's specific needs.
- Select the Change Shape button for Image and Shape.
- Choose Intel and VM.Standard3.Flex.
- Expand shape options.
- Configure the Number of OCPUs and Amount of memory (GB). Please note: It is recommended to have at least eight (8) cores for the cloudSwXtch instance. For more information on recommended sizing, please see cloudSwXtch System Requirements.
- Click Select Shape.
- Select Advanced Options.
- Select Next. This will bring the Security settings page. No security settings are required, select Next to get to Networking to enter in data for the Primary VNIC information.
- Optional: Add a name to the VNIC. If left blank, Oracle will assign it the name of the instance with a note that it is the Primary VNIC.
- Assign a VCN to the Primary VNIC.
- Select a subnet. Please note: This ctrl subnet will also be used for the secondary VNIC.
- Click on Advanced options.
- Click on Show advanced options.
- Select Hardware-assisted (SR-IOV) networking under Launch options.
- Scroll down and add an SSH key.
- For all the other tabs fill out data as appropriate, for example if users need tags or want more storage then add that data.
- Hit Create button.
### Step Three: Attach a Secondary VNIC
When deploying a cloudSwXtch, users will need two VNICs. Both can share a single subnet for control and data plane communications. In this step, we will walk through how to attach a secondary VNIC and how to manually add its IP to the cloudSwXtch instance.
1. Make sure that the**Instance with cloudSwXtch installed** is **running**. The user **cannot** attach a secondary VNIC if the machine is off.
2. Select Create**VNIC** under **Networking**.
3. Click **Create VNIC**.
1. **Pro-Tip**: Assign a user-friendly name to the secondary VNIC. Otherwise, Oracle will assign a randomized ID.
2. Choose the same **Virtual cloud network** and data **Subnet** as the Secondary VNIC.
3. Select **Submit Changes**.
4. Click on the freshly created VNIC's name after it finishes attaching.
5. Select the ellipsis next to the**Secondary data VNIC**and Record the **Private IP and the MAC address**. **It will be needed later.**
6. Log in to the **Instance with cloudSwXtch installed.**
7. Create the following file in the **/etc/netplan** folder and name it **02-datanic-static-config.yaml. Please note:**Users will need to add the Private IP Address and the correct MAC address of the **secondary**VNIC into the file below.
```shell
network:
version: 2
ethernets:
ens4:
match:
macaddress: -- --
dhcp4: false
addresses:
- /
```
Where the is the net mask (or network mask) of ctrl-plane CIDR (in single-subnet configuration). Example:
```shell
network:
version: 2
ethernets:
ens4:
match:
macaddress: 02:00:17:31:7E:E8
dhcp4: false
addresses:
- 10.0.138.84/24
```
1. Run the following command:
```shell
sudo chmod 600 02-datanic-static-config.yaml
```
2. Apply the new config:
```shell
sudo netplan apply
```
3. To ensure data can flow, edit /etc/iptables/rules.v4 file and add the following before “-A INPUT -j REJECT --reject-with icmp-host-prohibited.
Note that this is fully open; alternatively, add a line for every subnet in use, e.g., for the control and data.
```shell
-A INPUT -p all -s 0.0.0.0/0 -j ACCEPT
```
9. Save the file and reboot the instance.
**The secondary VNIC should now be successfully attached.**
Upgrading your cloudSwXtch
After deployment, it is recommended to update your cloudSwXtch instance to the latest. Please refer to the [Upgrading cloudSwXtch](/v2/docs/upgrading-cloudswxtch) article for more information.
### **Optional Step for BYOL: Contact swXtch.io for a license**
Users deploying a BYOL instance of cloudSwXtch will need to contact swXtch.io for a license file. For more information. See [How to License a cloudSwXtch](/v2/docs/how-to-license-a-cloudswxtch)**.**
**NEXT STEPS**
**The cloudSwXtch is ready to use**. The next step is to install the xNIC on each client expected to get traffic from the cloudSwXtch. See [Installing xNIC](/v2/docs/xnic-installation) for more information on preparing clients. Refer to [Licensing cloudSwXtch](/v2/docs/licensing-cloudswxtch) to license your cloudSwXtch.