Deploy a Gateway on Azure

Deploy and register the gateway on Azure Cloud environment to monitor and manage your resources.


Copy the Azure Gateway blob container URI to download the Azure VHD file.

Configure Azure

Perform the following steps to configure Azure:

  1. Creating resource groups.
  2. Setting up the gateway with Storage Explorer.
  3. Creating an image.
  4. Deploying a virtual machine (VM) using the gateway image

Create resource groups

A resource is a manageable item that is available through Azure. Virtual machines, storage accounts, web apps, databases, and virtual networks are examples of resources.
Create a resource group with a storage account using an Azure account.

To create resource groups, perform the following steps:

  1. Log into the Azure account where you want to install the gateway.
  2. Create a resource group for the OpsRamp gateway:
    1. On the left pane, click Resource groups.
    2. From the Resource groups screen, click +Add.
    3. Provide the Resource group name, select the required Resource group location, and click Create.
    4. Verify that the Resource group has been created.
  3. Create a storage account within the same resource group:
    1. On the left pane, click Storage accounts and click +Add.
    2. Select the resource group that you created for the OpsRamp gateway and click Review + create.
      Azure Storage Account Review

Setup a gateway with Storage Explorer

To set up the OpsRamp gateway using Storage Explorer, perform the following steps:

  1. Install the Storage Explorer.
  2. Open Azure Storage Explorer and add the Azure account (the same account that you created in the previous steps).
  3. Copy the OpsRamp VHD file to the Azure account and do the following:
    1. Go to the Storage account and select the storage account that was created.
    2. Click the Connection icon to launch the Connect to Azure Storage screen.
    3. Select the Use a shared access signature (SAS) URI option and click Next.
    4. From the Attach with SAS URI screen, enter the Gateway blob container link (provided by OpsRamp support)and click Next.
    5. Click Connect. The VHD file is downloaded.
    6. Copy the OpsRamp gateway VHD file from the OpsRamp blob container to the Azure account blob container that you created.
      Azure Storage Explorer Summary

Create an image

Azure allows you to define VM images or use pre-defined images. These images can be used to create one or more VM instances that look alike.
To create a new image for the gateway, perform the following steps:

  1. On the left pane, click +Create a resource.

  2. Enter Image in the search bar.

  3. Click Create.

  4. From the Create Image screen, provide the following:

    • Name: Enter a unique name for the gateway.
    • Subscription: Select the account for spinning up the gateway.
    • Resource Group: Select the resource created for the gateway.
    • Location: Select the location from the drop-down options.
    • OS disk: Linux
    • Storage Blob: Browse and select the downloaded OpsRamp Gateway VHD file and click Create.
  5. Verify that the new image has been created.

    Azure Image Created

Deploy a VM

To deploy a VM for the gateway using the created image:

  1. From the Images list, click the name of the image for the VM.
  2. Click +Create VM, provide the following information and click Next.
    • Resource Group: Resources created for the OpsRamp gateway.
    • Virtual Machine Name: Unique name for the VM.
    • Image: Gateway image that was created.
    • Size: Minimum requirement is 2 vCPUs, 4GiB memory.
    • Authentication Type: Password or SSH public key.
  3. On the disk screen, specify Premium SSD for the OS disk type and click Next.
  4. Go to NIC network security group > Advanced and ensure that port 22 and port 5480 are allowed on the gateway. These ports are required for accessing the web and serial user interface.
  5. Click Next.
  6. (Optional) Configure Advanced and Tags, and click Review + Create.
  7. From the Validation screen, click Create.
    Azure Deployment Complete

Register the Gateway

To register a gateway, the gateway registration has to be configured.

Configure the gateway registration

After creating a management profile, configure the gateway registration using one of the following methods:

  • Gateway administration console
  • Gateway web user interface

Configuring with the administration console

To configure the gateway using the administration console:

  1. Log into the gateway VM with the provided username and password.
    For default login credentials to log into the administration console, contact OpsRamp Support.
  2. From the left pane, click General.
  3. Verify that the Registration Status is Not Registered and the Tunnel Status is Not Established.
  4. Click Network, select Use Static IP address and then click Save.
  5. To configure the gateway to use Proxy, use CTRL+P to navigate to Proxy Settings.
    By default, Direct connection to the Internet is selected.
  6. Provide the OpsRamp server ( information and enter the activation token.
  7. Click Update Now to register the gateway to OpsRamp.
  8. Verify that the gateway is registered with OpsRamp.

Configuring with the web user interface

To configure the gateway using the web user interface:

  1. On the web browser, enter the URL using the following syntax: https://<enter Gateway IP address>:5480.
  2. From the gateway login screen, provide a default username and password.
  3. Click Network. If required, clear the Obtain an IP Address from DHCP selection and provide the static address.
  4. (Optional) Enter VLAN, Static Routing, and Proxy information.
  5. From the Administration menu, click Registration and provide the activation token.
  6. Provide the OpsRamp SaaS endpoint details ( and click Activate.
  7. Verify that the Registration Status displays a Registered and Success status.
    Registration URL Screen

Activate the Gateway

  1. Login to the Gateway Administration Web UI using the URL:
    Login to SSH to Gateway CLI with the default credentials:
    Note: To get the credentials, login to OpsRamp portal, go to Setup > Downloads > Gateway.
  2. Go to Registration and enter:
    • API Server: copy and enter the host url.
    • Activation Token: copy and enter the activation token.
  3. Complete the registration.
  4. Change the default password.