Add a New IP Address — Quick & Clear Guide
Overview
This interface allows you to add IPv4 addresses or ranges to your server’s IP address pool. These IPs can later be used, for example, to assign dedicated IP addresses to accounts or services.
Note: If you're unsure about the address or subnet mask, ask your network provider to avoid misconfiguration.
You can add multiple addresses in one go using:
- Class C CIDR: e.g.,
192.168.0.128/25 - IP/Netmask: e.g.,
192.168.0.128/255.255.255.128 - IP Range: e.g.,
192.168.0.128-255
Important: You must add IPs via this interface for the system to recognize them later.
How to Add IPs
- Enter one or more IPs (or ranges) into the “New IP or IP range to add” field.
-
Select the appropriate subnet mask from the drop-down menu.
- If using CIDR format, use a mask between 24 and 30.
- Optionally, enter any IPs or ranges that you want to exclude.
- Click **Submit** to add the IP(s) to your pool.
What Happens Behind the Scenes
When IPs are added, the system attempts to alias them to the primary network interface, then rebuilds the IP pool, reflected in:
/etc/ipaddrpool— location of the IP pool database/etc/ips— where IP addresses are stored
The ipaliases service ensures these IPs are activated when the server starts.
Advanced Option: API or CLI
For automation or scripting, you can use the following API request example:
whmapi1 --output=jsonpretty addips ips='192.168.0.20/28' netmask='255.255.255.0'
This will add the specified IPs programmatically.
Summary
- Enter IP or range in supported formats
- Select a correct subnet mask
- Optionally exclude specific IPs
- Submit to add IP(s) to the pool
- System updates pool files and activates aliases
- API option available for automation
