Overview
Floating IPs provide external access to instances running on private networks. A floating IP maps a publicly routable address to an instance’s private port via NAT on the router. You can associate, disassociate, and reassign floating IPs without downtime.Prerequisites
- An active Polystack account with appropriate permissions
- Access to the Polystack Dashboard or CLI configured with credentials
- API credentials sourced (
source openrc.sh)
A router with an external gateway must be connected to the instance’s network before
floating IPs can be associated. See Routers.
Allocate a Floating IP
- Dashboard
- CLI
1
Navigate to Floating IPs
Navigate to Network > Floating IPs in the sidebar. Click Allocate IP.
2
Configure the allocation
Administrators see an additional Project selector to allocate IPs
for other projects. If QoS is enabled on the platform, a QoS Policy
selector also appears for all users.
3
Allocate
Click Confirm. The floating IP appears in the list with status Down
(not yet associated with an instance).
Floating IP allocated and ready for association.
View Floating IPs
- Dashboard
- CLI
Navigate to Network > Floating IPs. The list shows:
Associate with an Instance
- Dashboard
- CLI
1
Open the Associate dialog
On the floating IP row, click Associate (available when status is
Down or Available).2
Select the target
Select the instance port to associate with from the fixed IP table.
Ports that are not routable to the external network show a reason label.Click Confirm.
The floating IP status changes to Active and shows the associated instance.
Disassociate a Floating IP
- Dashboard
- CLI
On the floating IP row, click Disassociate (available when status is
Active).
Confirm the action. The IP returns to Down status and can be reassigned.Release a Floating IP
- Dashboard
- CLI
Click the More dropdown on the floating IP row and select Release.
The IP is returned to the external network pool.
Releasing a floating IP is permanent. If you release a static IP that DNS
records or external systems reference, those references will break immediately.
Next Steps
Routers
Set up the external gateway required for floating IP routing
Security Groups
Allow inbound traffic on the floating IP’s port
Create a Network
Provision the internal network for your instances
Launch an Instance
Create an instance to associate the floating IP with