Register New Edge Runtime with webMethods.io Integration
Tags: edge, runtime, integration, webmethods
Published: 2024-02-21 14:39:55

---
title: Register New Edge Runtime with webMethods.io Integration
published: true
date: 2024-02-05 13:34:11 UTC
tags: edge, runtime, integration, webMethods
canonical_url: https://tech.forums.softwareag.com/t/register-new-edge-runtime-with-webmethods-io-integration/289844
---

 

_products: [webMethods.io](http://webMethods.io) Integration_

## Introduction

Edge runtimes form part of the integration execution layer, allowing you to develop and deploy anywhere. In this tutorial, learn how [webMethods.io](http://webMethods.io) Integration makes it easy for you to quickly register and connect with your edge runtimes.

This is the third part of a series of [webMethods.io](http://webMethods.io) Integration tutorials exploring the platform’s Super iPaaS Develop anywhere, deploy anywhere capabilities. If you missed the previous part, you can find it here: [Monitor your integration runtimes remotely with webMethods.io Integration](https://tech.forums.softwareag.com/t/monitor-your-integration-runtimes-remotely-with-webmethods-io-integration/289841).

> **Prefer watching a video?** See our Developer Evangelist Theo Ezell walk through the steps in this video tutorial:  
> ![:film_projector:](https://emoji.discourse-cdn.com/twitter/film_projector.png?v=12 ":film\_projector:") [Register a New webMethods.io Integration Runtime | Demo](https://www.softwareag.com/en_corporate/resources/application-integration/demo/register-webmethods-io-runtime.html)

## Pre-requisite

- A [webMethods.io](http://webMethods.io) Integration environment.

> **Note:** These capabilities are not available by default. Contact your sales representative for more information.

- A container runtime, such as Docker or Rancher installed on your machine.
- A [Software AG container registry](https://containers.softwareag.com/) username and token.

## Steps

Log in to your [webMethods.io](http://webMethods.io) Integration environment and navigate to the **Integration Runtimes** tab. To create a new runtime, click the Plus sign:

[![Integration Runtimes tab](https://global.discourse-cdn.com/techcommunity/optimized/3X/f/a/fad06574af1f527fe61784e823f06414e95f5dbd_2_690x372.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/f/a/fad06574af1f527fe61784e823f06414e95f5dbd.jpeg "Integration Runtimes tab")

In the Register Edge Runtime wizard select the **Create new Edge Runtime** option and click Next.

[![Create new Edge Runtime](https://global.discourse-cdn.com/techcommunity/optimized/3X/f/9/f9f62f6474d130b97ecbd2d4edeed01bd449dd21_2_623x500.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/f/9/f9f62f6474d130b97ecbd2d4edeed01bd449dd21.jpeg "Create new Edge Runtime")

This will display the Docker command needed for logging into the [Software AG container registry](https://containers.softwareag.com).

[![Get Edge Runtime Image](https://global.discourse-cdn.com/techcommunity/optimized/3X/0/4/04c18cc3a3a9483bf256c688a04fd941dd0737ad_2_625x500.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/0/4/04c18cc3a3a9483bf256c688a04fd941dd0737ad.jpeg "Get Edge Runtime Image")

If you do not have your username and token, click the Container registry link first, log in and generate your credentials from the profile settings page.

![Generate Container registry credentials](https://global.discourse-cdn.com/techcommunity/original/3X/c/a/ca804cde3ff577ee32b6907cc6a858fb77c3d1a4.png)

Once you have your credentials, open a terminal, for example PowerShell and run the Docker login command by replacing the user name and the user token.

The next step is to get the Edge Runtime image – copy the second Docker command and run it in the terminal.

[![Run get Edge Runtime image command](https://global.discourse-cdn.com/techcommunity/optimized/3X/2/e/2e82cde09ae4aae67e4441e256b7c8a1334393ec_2_690x113.png)](https://global.discourse-cdn.com/techcommunity/original/3X/2/e/2e82cde09ae4aae67e4441e256b7c8a1334393ec.png "Run get Edge Runtime image command")

> Please note that it is not necessary to download the Docker image every time but it’s best to make sure you are working with the latest release.

Once the Edge Runtime images have been downloaded, go back to your [webMethods.io](http://webMethods.io) Integration environment and click Next to continue to the Configuration tab:

[![Configure Edge Runtime](https://global.discourse-cdn.com/techcommunity/optimized/3X/1/b/1bf73edf3f3abb4a635493aee6b5a5007e8bf5f4_2_638x500.png)](https://global.discourse-cdn.com/techcommunity/original/3X/1/b/1bf73edf3f3abb4a635493aee6b5a5007e8bf5f4.png "Configure Edge Runtime")

Select a proper name and description for your Runtime and click Next. In the Connect tab click the **Start Pairing** button to generate the pairing code needed to launch your container in Docker and pair it with the integration in the cloud.

[![Start pairing](https://global.discourse-cdn.com/techcommunity/optimized/3X/8/a/8a1cc7b476b6e8b6dc85da843d6adfb4fe26f36a_2_633x500.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/8/a/8a1cc7b476b6e8b6dc85da843d6adfb4fe26f36a.jpeg "Start pairing")

Copy the command and run it in the terminal.

[![Connect tab](https://global.discourse-cdn.com/techcommunity/optimized/3X/c/b/cb6c49097601686ad5c454b971dd54c5808e2cc1_2_595x500.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/c/b/cb6c49097601686ad5c454b971dd54c5808e2cc1.jpeg "Connect tab")

[![Connect Edge Runtime command](https://global.discourse-cdn.com/techcommunity/optimized/3X/b/a/ba536eb97585a221e98e5152ca12e39c529b902f_2_690x56.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/b/a/ba536eb97585a221e98e5152ca12e39c529b902f.jpeg "Connect Edge Runtime command")

When it’s done, your Edge Runtime should be successfully registered.

Navigate again to the **Integration Runtimes** tab in your [webMethods.io](http://webMethods.io) Integration environment and find your Runtime in the list or use the search option. After a couple of seconds, you should see that your Runtime is both running and enabled.

[![Newly created Edge Runtime](https://global.discourse-cdn.com/techcommunity/optimized/3X/4/c/4caf173eb96c67b61db995686bdf3aec3cbbd12e_2_690x290.jpeg)](https://global.discourse-cdn.com/techcommunity/original/3X/4/c/4caf173eb96c67b61db995686bdf3aec3cbbd12e.jpeg "Newly created Edge Runtime")

You can now click into it and view the current state of the runtime, projects that have been deployed, the server logs, etc.

## What’s next

Now you know how quickly you can register a new [webMethods.io](http://webMethods.io) Integration runtime. Next, learn how to create and manage [webMethods.io](http://webMethods.io) Integration Projects from this how-to:

> [Find out how webMethods.io helps you create and manage your integration projects](https://tech.forums.softwareag.com/t/create-and-manage-your-webmethods-io-integration-projects/289849)

## Useful links | Relevant resources

- [Register a New webMethods.io Integration Runtime | Demo](https://www.softwareag.com/en_corporate/resources/application-integration/demo/register-webmethods-io-runtime.html)
- [Software AG container registry](https://containers.softwareag.com)
- [What is Develop Anywhere, Deploy Anywhere? - Knowledge base / Blog - webMethods - Software AG Tech Community & Forums](https://tech.forums.softwareag.com/t/what-is-develop-anywhere-deploy-anywhere/284756)
- [Monitor your integration runtimes remotely with webMethods.io Integration](https://tech.forums.softwareag.com/t/monitor-your-integration-runtimes-remotely-with-webmethods-io-integration/289841).
- [Edge Runtime Management with webMethods.io Integration](https://tech.forums.softwareag.com/t/edge-runtime-management-with-webmethods-io-integration/287803)


[Read full topic](https://tech.forums.softwareag.com/t/register-new-edge-runtime-with-webmethods-io-integration/289844)