The swapip utility allows you to specify parameters from the command line in order to update nameserver records. This is useful, for example, if you moved an account from one server to another and did not use the Express Transfer option in WHM's Transfer Tool interface (WHM >> Home >> Transfers >> Transfer Tool).

The swapip utility

The swapip utility resides in the /usr/local/cpanel/bin/swapip file.

To use this utility, run the following command:

/usr/local/cpanel/bin/swapip sourceip targetip ftpip domains


All of the parameters for the swapip utility are required .

The example above uses the following parameters:

Example parameterInput typeDescriptionExample
sourceipstringThe old IP address.
targetipstringThe new IP address.
ftpipstringThe new FTP server's IP address.
domainsstringOne or more domains that are associated with the old IP address. Space-separate multiple domain names.example.com


To change the nameserver records for the example.com domain on the IP address in order to point HTTP and FTP requests to the IP address, run the following command:

/usr/local/cpanel/bin/swapip example.com 

If the swapip utility does not succeed, the output will resemble the following example:

root@example [~]# /usr/local/cpanel/bin/swapip example.com
Error: domains missing
Usage: /usr/local/cpanel/bin/swapip sourceip destip ftpip domains...


If the swapip utility succeeds, the output will resemble the following example:

root@example [~]# /usr/local/cpanel/bin/swapip example.com
root@example [~]#  

At this time, the error message may not give an accurate assessment of the error that occurrs.

Additional documentation