# Running Enapter Gateway Software in Oracle VirtualBox

# Prerequisites

  • Oracle VirtualBox installed on your computer
  • Enapter VMDK image file (e.g., enapter-linux-2.5.2.487509.vmdk)
  • At least 60GB of free disk space
  • 4GB of available RAM minimum

# Setup Process

# Step 1: Create a New Virtual Machine

  1. Open Oracle VirtualBox Manager
  2. Click the "New" button in the toolbar
  3. This will start the virtual machine creation wizard

VirtualBox Manager main screen with New button highlighted

# Step 2: Configure Virtual Machine Name and Operating System

  1. Enter a descriptive name for your VM (e.g., "EnapterGateway")
  2. Set the folder path where the VM will be stored
  3. Important: Do NOT select an ISO image at this stage
  4. Configure the operating system settings:
    • Type: Linux
    • Subtype: Other Linux
    • Version: Other Linux (64-bit)
  5. Click "Next"

VM Name and Operating System Configuration

# Step 3: Configure Hardware Resources

  1. Set the Base Memory to minimum 4096 MB (4GB)
  2. Set the number of processors to 2
  3. Critical Setting: Enable EFI (special OSes only) by checking the box
  4. Click "Next"

Hardware Configuration with EFI enabled

# Step 4: Configure Virtual Hard Disk

  1. Select "Use an Existing Virtual Hard Disk File"
  2. The dropdown will be empty initially, so click the folder icon to browse for your disk image

Virtual Hard Disk Configuration

# Step 5: Select the Enapter VMDK Image

  1. In the Hard Disk Selector dialog, click "Add" to browse for the Enapter system disk image

Hard Disk Selector Add Button

# Step 6: Browse for the Enapter VMDK File

  1. Navigate to the location where you saved the Enapter VMDK file
  2. Select the file enapter-linux-2.5.2.487509.vmdk
  3. Click "Open"

File Browser for VMDK Selection

# Step 7: Confirm the Hard Disk Selection

  1. Verify the VMDK file appears in the list showing:
    • Name: enapter-linux-2.5.2.487509.vmdk
    • Virtual Size: 4.00 GB
    • Actual Size: 1.34 GB
  2. Select the disk and click "Choose"

Hard Disk Selection Confirmation

# Step 8: Complete Initial VM Setup

  1. Confirm the virtual hard disk is now selected
  2. Click "Next" to proceed

Virtual Hard Disk Selected

# Step 9: VM Created - Access Settings

  1. Your VM is now created and appears in the VirtualBox Manager
  2. Click on "Settings" to configure additional storage

VM Settings Button

# Step 10: Configure Storage Settings

  1. In the Settings dialog, select "Storage" from the sidebar
  2. You will see the existing "Controller: SATA" with the Enapter VMDK disk
  3. Click the "+" icon next to the SATA controller to add a new disk

Storage Settings Configuration

# Step 11: Create Additional Hard Disk

  1. In the Hard Disk Selector dialog, click "Create" to make a new virtual disk for user data

Create New Hard Disk

# Step 12: Select Virtual Disk File Type

  1. Choose "VDI (VirtualBox Disk Image)" as the file type
  2. Click "Next"

Virtual Disk File Type Selection

# Step 13: Configure Storage Allocation Type

  1. Choose between dynamically allocated (grows as needed) or fixed size
  2. The default (dynamically allocated) is recommended
  3. Click "Next"

Storage Allocation Type

# Step 14: Set Data Disk Size and Location

  1. Name the disk file (or you can keep auto generated name)
  2. CRITICAL: Set the disk size to at least 60 GB minimum
    • Drag the slider or enter the value directly
  3. Click "Finish"

Disk Size Configuration

# Step 15: Confirm the New Disk

  1. You should now see both disks in the Hard Disk Selector:
    • The original Enapter VMDK (4 GB)
    • The new data disk (60 GB)
  2. The new disk will be selected automatically
  3. Click "Choose" to add it to your VM

New Disk Confirmation

# Step 16: Finalize Storage Configuration

  1. Verify both disks appear under "Controller: SATA" section
  2. Click "OK" to save the settings

Finalize Storage Settings

# Step 17: Start and Run the Enapter Gateway

  1. Back in the VirtualBox Manager, select your VM and click "Start"
  2. The VM will boot into the Enapter Gateway software
  3. You will see the welcome screen with instructions for accessing the Gateway

Enapter Gateway Running

# Important Notes

  • The minimum hardware requirements are: 4GB RAM, 60GB storage space for the data disk
  • EFI/UEFI boot must be enabled for the system to work properly
  • No ISO image is needed as the VMDK file already contains the operating system
  • The Gateway is accessed through a web interface from your browser

Was this page useful?