# UPnP Nat

UPnP Nat Client helps to automatically enable port forwarding depending on the network ([gateway identifiers](/flyingfish/index/configurations/listen/gateway-identifiers.md)) on the router.

{% hint style="info" %}
Upnp-Nat must be activated on the router. With the Fritzbox you have to allow UPnP-Nat for a host device.
{% endhint %}

## List

All port forwarding can be seen in the list, per [Gateway identifiers](/flyingfish/index/configurations/listen/gateway-identifiers.md) and [Listen](/flyingfish/index/configurations/listen.md)/port.

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

1. Adds a new port forwarding for UPnP Nat.
2. Entries for UPnP Nat.

#### Status

Gray status shows that we are not currently in the gateway, these port forwarding are being ignored.&#x20;

A <mark style="color:red;">red status</mark> indicates that port forwarding could not be set up automatically. This could be a problem with:

{% hint style="danger" %}

* UPnP Nat is not active on the router
* The device does not have permission for UPnP Nat. (e.g. Fritzbox)
* The port is already taken and cannot be released again.
  {% endhint %}

The <mark style="color:green;">green status</mark> indicates that port sharing has been set up.

## Add

Adds UPnP Nat port forwarding:

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

1. **Gateway network assignment**: Select your gateway. The gateways of "[Gateway identifiers](/flyingfish/index/configurations/listen/gateway-identifiers.md)" are displayed here.
2. **Gateway address**: Enter the IP address of the gateway (router) on which UPnP Nat is requested.
3. **Public port**: Port that is opened to the Internet.
4. **Client address**: Enter the target IP address here. If it is FlyingFish and not another application from another system, you can simply use the "Use Host address by DHCP".&#x20;

{% hint style="info" %}
When activating "Use Host address by DHCP" the host's IP, which it received as an IP, is always used automatically.
{% endhint %}

5. **Privat port**: Here you enter the port which is located in the network and which should be released to the outside world on the Internet.  Or select a [Listen](/flyingfish/index/configurations/listen.md) directly.
6. **TTL**: The time (in seconds) for how long the [port forwarding](/flyingfish/index/configurations/listen/port-forwarding.md) requested by the client is valid. Default is 36000 seconds.
7. **Protocol**: What protocol is used for [port forwarding](/flyingfish/index/configurations/listen/port-forwarding.md)? The router then only passes on this protocol. TCP and UDP can be selected.
8. **Description**: Description for [port forwarding](/flyingfish/index/configurations/listen/port-forwarding.md).

<figure><img src="/files/OeOeW59m4W8uLjgC0Cjc" alt=""><figcaption><p>Generate by <a href="https://imgflip.com/i/80bxpq">https://imgflip.com/i/80bxpq</a></p></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://flying-fish.gitbook.io/flyingfish/index/configurations/listen/upnp-nat.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.
