--- title: VirtualBox MacOS slug: litmusedge-v2/quickstart-guide/installation-and-deployments/iso-installation-on-hypervisors/virtualbox-macos description: You can use Oracle VirtualBox on MacOS BigSur to install Litmus Edge. docTags: createdAt: 2022-04-18T14:13:52.000Z --- You can use Oracle VirtualBox on macOS Big Sur to install Litmus Edge. # Before You Begin - Prepare your environment for running virtualization by using Oracle VirtualBox. - Review [Verified VM Versions](docId\:Xf4LiBP1MS2tlkZ7MrOKP) and confirm the correct version to download. See  [VirtualBox Downloads](https://www.virtualbox.org/wiki/Downloads). - Refer to [VirtualBox Documentation](https://www.virtualbox.org/wiki/Documentation) to learn more. - The virtual machine will run on the same physical network card as the host environment. To ensure that the device can communicate with data sources such as PLC, DCS or CNC and can be accessed through the Web UI, make sure that communication can be established. - Adjust the system clock for the host environment prior to installing Litmus Edge. UTC is recommended. The 15-day trial period may be rejected and invalidated by the license server if the system clock is not adjusted. If this happens, contact your Litmus representative. - Obtain a valid file in the ISO format (example filename: `.iso`). You can get the ISO file from the [Litmus Central portal](https://central.litmus.io/). To use VirtualBox on macOS Big Sur to install Litmus Edge, you will need to do the following. - Step 1: Create a Virtual Machine - Step 2: Configure Settings - Step 3: Log in to Litmus Edge To jump to a specific section, refer to the Table of Contents on the right side and click the corresponding step. # Step 1: Create a Virtual Machine You will first need to create the virtual machine that will run Litmus Edge. **To create the virtual machine:** 1. Start the Oracle VirtualBox application. 2. Click the **New **icon. 3. From the Name and operating system dialog box, configure the following. - **Name**: Enter a name for the virtual machine. - **Type**: Select **Other**. - **Version**: Select **Other/Unknown (64-bit)**. 4. Click **Continue**. The *Memory size* dialog box appears. 5. From the Memory size dialog box, enter `4096` in the **MB **field. 6. Click **Continue**. The *Hard disk* dialog box appear. 7. From the *Hard disk* dialog box, select **Create a virtual hard disk now** and click **Create**. The *Hard disk file type* dialog box appears. 8. From the *Hard disk file type* dialog box, Select **VDI** (**VirtualBox Disk Image**) and click **Continue**. The *Storage on physical hard disk dialog box* appears. 9. From the *Storage on physical hard disk dialog box*, select **Fixed size **and click **Continue**. The* File location and size* dialog box appears. 10. From the *File location and size* dialog box, Enter `32.00` in the **Size** field and click **Create**. The progress bar appears, and then the* Hard disk *dialog box appears. 11. From the *Hard disk* dialog box, select **Create a virtual hard disk now** and click **Create**. The *VirtualBox Manager* appears. # Step 2: Configure Settings After installing the virtual machine, you will need to configure its settings. **To configure the settings:** 1. From the open Oracle VirtualBox application, select the deployed virtual machine from the left pane. 2. Click the **Settings** icon, and then click the **General** section in the right pane. The *General *dialog box appears. 3. From the *General *dialog box, select the **System** icon at the top. The *System *dialog box appears. 4. From the *System *dialog box, configure the following. - **Enable I/O APIC**: Select the checkbox. - **Hardware Clock in UTC Time**: Select the checkbox. - **Processor**: Click **Processor **and enter `2`. 5. Click **Storage**. The *Storage *dialog box appears. 6. From the *Storage *dialog box, select the **Empty** device in the left pane. 7. Hover over the **Optical Drive** icon and select **Choose a disk file**. 8. Navigate to the *ISO *file, and then click **Open**. 9. Click **Network**. The *Network *dialog box appears. 10. From the *Network *dialog box, select** Bridged Adapter **from the *Attached to* drop-down list and the appropriate network card name. 11. Click **OK**. The *VirtualBox Manager* appears. 12. From the* VirtualBox Manager*, Click **Start**. The Terminal User Interface (TUI) opens and runs the installation you configured, and then the VirtualBox Manager appears. 13. Click **Settings**, and then click **System**. 14. From the *System *dialog box, configure the following: - **Optical**: Uncheck the check box. - **Hard Disk**: Select **Hard Disk** and click the **Up** arrow to move it up in the boot order. - **Enable EFI (special OSes only)**: Select the check box. 15. Click **OK**. The *VirtualBox Manager* appears. 16. Click **Start**. The VM starts up and the terminal window displays the URLs to be used to access the edge device through the Web UI. If several URLs are shown, use the first one. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/JJVFrtma1Ce-ow2-N7VQL_image.png "URLs to access Web UI") After you create the virtual machine, you must configure the network adapters. # Step 3: Log in to Litmus Edge - See [Access the Litmus Edge Web UI](docId\:Y_HKza2PmC4IRUk-EBOuK) for details on logging in. - See [Access the Terminal User Interface](docId\:gsDVWB7QWhdhuQf7fkAHC) for instructions on how to navigate and log in for the first time. # Troubleshooting If you don't see an option for a 64-bit version and only see a 32-bit version, refer to [Installation and Deployments Troubleshooting](docId\:pP6sS02OW_Bk-OclIIjHc).