Child pages
  • The swapip Utility
For cPanel & WHM version 70

Skip to end of metadata
Go to start of metadata


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


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


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

root@example [~]# /usr/local/cpanel/bin/swapip
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
root@example [~]#  


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

Additional documentation