> For the complete documentation index, see [llms.txt](https://docs.defguard.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defguard.net/2.0/tutorials/adding-edge-component.md).

# Adding Edge component

### Navigate to Edge Components

1. Log in to the Defguard web UI as an administrator.
2. In the left sidebar, click **Edge Components**.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-e88bf3568ed836d8292c4f3d68beb1deff0d45c9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Click "Add Edge Component"

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-d0f668a12b1035180de4f310f5808622e4f3035a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Welcome screen

Click **Configure Edge component**.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-a7510834c76b9444a73e800d4218e5bc7675bfbf%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Deploy Edge component

This step provides ready-to-use deployment commands for every supported method. Choose the tab that matches your environment and continue when your Edge component is up and running ready to be adapted.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-7ff2bdff751bcaef8af8a47f468b86f7426c6589%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Configure Edge component

This step registers the running Edge instance in Defguard Core.

| Field            | Description                                                                                              | Example                           |
| ---------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------- |
| **Edge Name**    | A unique, human-readable identifier for this instance. Shown in the Edge Components list.                | `edge-eu-west-1`                  |
| **IP or Domain** | The IP address or hostname of the server where Edge is deployed. Core connects here to perform adoption. | `edge.example.com` or `10.0.1.50` |
| **gRPC Port**    | The port Edge listens on for gRPC. Change only if you modified the default.                              | `50051`                           |

> The Edge Name must be unique, the wizard will warn you if a component with the same name already exists.

When all fields are valid, click **Adopt Edge component**.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-77db5f4c1390d962bc2cdb463f0fd4378d04eb33%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Edge Component Adoption

Core now connects to the Edge service and performs automated adoption. The wizard shows live progress through each stage.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-7574f9a046f26e039cf33b9855992e8b8de27509%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If any stage fails, an **error log** is shown and a **Retry** button becomes available. You can also click **Back** and correct the configuration from the pervious step.

Once all stages complete, click **Continue**.

### Confirmation

Success! You’ve finished setting up the Edge component.

<figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-311660b908179c5681f88e57d88dec96dfcc97c4%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>