A Bash script to update DNS record on Namecheap.

Before you run the script, please make sure that you have set up your Namecheap DDNS A record. Instruction can be found here.

Also make sure you have the DDNS password with you. If you haven't, please follow the steps below.

First, login to your Namecheap panel, then go to Domain List >> click Manage next to the domain >> Advanced DNS tab >> Scroll to Dynamic DNS section. If it is not enabled, enable it to get the password.

Your record will not hit the Namecheap API if the given IP is identical to the remote DDNS record. However, if you still want to force push the already existed record for testing purpose, you could pass -f or --force argument.

$ ./updateDNS.sh --force

By doing this, the script will send a request even if the DDNS record needs not to be updated. It is not recommended to use in production mode.

1. Clone the repository to you local machine
2. Change directory into the cloned repository
3. Run updateDNS.sh script

   $ ./updateDNS.sh

4. Following prompt, enter required parameters

Just export required environment variables, and run updateDNS.sh script.

You can use export to set environment variables in your current terminal session, and you can reuse them. For example,

$ export HOST=www
$ export DOMAIN_NAME=haomingyin.com
$ export PASSWORD=sample-password
$ ./updateDNS.sh

Or simply,

$ HOST=www DOMAIN_NAME=haomingyin.com PASSWORD=smaple-password ./updateDNS.sh

Namecheap official guideline of setting up DDNS using your browser.

• Successful response

<?xml version="1.0"?>
<interface-response>
    <Command>SETDNSHOST</Command>
    <Language>eng</Language>
    <IP>127.0.0.1</IP>
    <ErrCount>0</ErrCount>
    <ResponseCount>0</ResponseCount>
    <Done>true</Done>
    <debug>
        <![CDATA[]]>
    </debug>
</interface-response>

• Error response

<?xml version="1.0"?>
<interface-response>
    <Command>SETDNSHOST</Command>
    <Language>eng</Language>
    <ErrCount>1</ErrCount>
    <errors>
        <Err1>No Records updated. A record not Found;</Err1>
    </errors>
    <ResponseCount>1</ResponseCount>
    <responses>
        <response>
            <ResponseNumber>380091</ResponseNumber>
            <ResponseString>No updates; A record not Found;</ResponseString>
        </response>
    </responses>
    <Done>true</Done>
    <debug>
        <![CDATA[]]>
    </debug>
</interface-response>