Multiple Public IP

Multiple Public IP Addresses for a Single Container

A single container can use several public IPv4 and IPv6 addresses at the same time. This allows multiple websites or network services to run on one node while using separate domains, SSL certificates, and external addresses.
Multiple IPv4 and IPv6 addresses
A container can receive several public addresses of one or both IP versions.
Multiple WebsitesAssign a dedicated public address, custom domain, and SSL certificate to each hosted website.
Network AppliancesUse several addresses for load balancers and other services that require separate external networks.
Billing: Public IPv4 and IPv6 are paid options and are charged separately on an hourly basis. Review the available limits and pricing under Quotas & Pricing > Account Limits.

Assign Multiple Public IP Addresses

Public addresses can be assigned while creating a new environment or while changing the topology of an existing one.

1Open the topology wizard

Create a new environment or open Change Environment Topology for an existing environment.

2Set the address quantity

Use the Public IPv4 and Public IPv6 fields to enter the required number of addresses for the selected layer.

Assign multiple public IP addresses in the topology wizard
Set separate quantities for public IPv4 and IPv6 addresses.
When the required number exceeds the account limit, contact the hosting provider to request a higher public-IP quota.

Manage Assigned Addresses

Each node in the dashboard lists its private IP first, followed by public IPv4 addresses and then public IPv6 addresses.

  • Private IP — automatically assigned internal address.
  • Public IPv4 — one address or an expandable list of all IPv4 addresses.
  • Public IPv6 — one address or an expandable list of all IPv6 addresses.
Manage multiple public IP addresses in the dashboard
View, copy, attach, or detach individual IPv4 and IPv6 addresses.

Use the controls beside an address to copy it or detach it. The Attach/Detach IP(s) action changes the total number of addresses for that IP version.

Change the number of public IP addresses
Adjust the total number of attached public addresses and click Apply.

Primary Public IP Behaviour

The first public address added for each IP version is treated as the primary address and is displayed first in its list.

  • The primary address cannot be removed while other addresses of the same version remain attached.
  • The primary address is used for incoming and outgoing traffic.
  • Additional public addresses can receive incoming traffic but are not the default source for outgoing traffic.
Default IP version: When automation does not explicitly specify the IP version, IPv4 is selected by default.

View Addresses through SSH Gate

All addresses assigned to a container are also visible when connecting to the environment through SSH Gate.

Multiple public IP addresses in SSH Gate
The WAN IP column lists public IPv4 addresses first and IPv6 addresses afterward, while LAN IP shows the internal address.

API Reference

SetExtIpCount

Use SetExtIpCount to increase or reduce the number of public IPv4 or IPv6 addresses attached to a container.

https://{hoster-api-host}/1.0/environment/control/rest/setextipcount
?envname={string}
&session={string}
&type={ipv4|ipv6}
&count={int}
&nodegroup={string}
&nodeid={int}
ParameterDescription
envnameName of the source environment.
sessionCurrent user-session ID.
typePublic-IP version: ipv4 or ipv6.
countRequired total number of addresses per container.
nodegroupDestination node group, such as bl, cp, sqldb, nosqldb, storage, vps, or build.
nodeidID of the destination node.
The older AttachExtIp and DetachExtIp methods are deprecated but remain available for backward compatibility.

SwapExtIps

Use SwapExtIps to exchange public IP addresses between two nodes in the same or different environments.

https://{hoster-api-host}/1.0/environment/control/rest/swapextips
?envname={string}
&session={string}
&sourcenodeid={int}
&destnodeid={int}
&sourceip={string}
&destip={string}

Omit sourceip and destip to swap all public addresses between the selected nodes.

API limitation: SwapExtIps currently supports public IPv4 addresses only.

What’s next?