Skip to content
You are reading Pantheon development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.


Enable UPnP to quickly allow inbound peer connections without manual router configuration. Use UPnP in home or small office environments where a wireless router or modem provides NAT isolation.

UPnP automatically detects that a node is running in a UPnP environment and provides port forwarding.


UPnP support is often disabled by default in networking firmware. If disabled by default, explicitly enable UPnP support.

Enabling UPnP

Use the --nat-method command line option to enable UPnP.


Enabling UPnP may slow down node startup, especially on networks without a UPnP gateway device.

When UPnP is enabled:

  • Enode advertised to other nodes during discovery is the external IP address and port.
  • External address and port are returned by the admin_NodeInfo JSON-RPC API method for the enode and listenAddr properties.

While Pantheon is running, UPnP does not support:

  • IP address changes
  • Disabling UPnP. To disable UPnP, restart the node without the --nat-method option or set to NONE.
Questions or feedback? You can discuss issues and obtain free support on Pantheon Gitter channel.
For paid professional support by PegaSys, contact us at [email protected]