Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Public IP

Access a service interface directly using a gateway’s public IP address and port number, without a domain name. This is a low-level option for specific protocols and use cases where a domain is unnecessary or undesirable.

Use Case

Some protocols — such as Bitcoin P2P, Lightning, and other peer-to-peer services — communicate using raw IP addresses and ports rather than domain names. For these services, a public IP address may be all that’s needed.

For hosting websites or APIs that people access in a browser, use a public domain instead. Public IPs accessed in a browser will display certificate warnings because Let’s Encrypt does not sign certificates for IP addresses. Visitors would need to trust your Root CA, which is not reasonable for public access.

Enabling a Public IP Address

  1. On the service interface’s addresses page, locate the gateway you want to use.

  2. Find its public IPv4 address and toggle it on.

IP Stability

If your gateway is your home router, be aware that your ISP can change your home IP address at any time. When this happens, any peers or services configured to reach you at the old IP will lose connectivity. Unlike clearnet domains, there is no dynamic DNS equivalent for raw IP addresses.

If you need a stable public IP, use a StartTunnel gateway. VPS providers assign static IPs that don’t change.

Port Forwarding

The selected port must be forwarded in the corresponding gateway. StartOS tests port forwarding automatically when you add or enable a public IP address, and will guide you through the setup if the test fails.