# 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="/files/5Too8RGhtoorgLV8JA7Y" alt=""><figcaption></figcaption></figure>

3. Click "Add Edge Component"

<figure><img src="/files/A9G57JcA8TFnORUhbiUP" alt=""><figcaption></figcaption></figure>

### Welcome screen

Click **Configure Edge component**.

<figure><img src="/files/OuTbO5AdaHLUv6f2RvTm" 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="/files/hE8JY35Esq0yXf9JETbq" 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="/files/13DC8xaA4OIqHV7TWBl6" 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="/files/RJcIap9v3I6w5RxfTgDT" 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="/files/m3yYOpYTNiFA3WCN7nZn" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.defguard.net/tutorials/adding-edge-component.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.