Q: How Do I Use The SuperDDNS Updater For Linux?

A:

To update your Hostnames using the SuperDDNS Updater For Linux, follow the steps below. You will need the following:

  • A UserID
  • A HostID
  • cURL installed
  • Root or sudo level permissions


Table Of Contents

  • Distro Compatibility
  • Installation And Setup
  • Additional Parameters
  • File Locations


  • Distro Compatibility

    If the chart below does not include your distro of choice, it may still be compatible. The SuperDDNS Updater For Linux requires the following for installation:

    • The systemd service manager
    • cURL

    However, you can still run the Updater in interactive, or background mode on distros without systemd.

    Distro Version
    Mint 19.3
    Ubuntu 20.04
    Debian Buster
    Raspberry Pi OS (Raspbian) May 2020
    Proxmox 6.2.1
    Kali 2020.2
    Tails 4.6
    Pop!_OS 20.04
    Zorin 15.2
    Elementary OS 5.1
    Untangle 15.0
    OpenSuse Leap
    Fedora 32
    CentOS 8.1
    Manjaro 20.01
    Arch 2020.05.01
    Solus Fortitude



    Installation And Setup

    Step 1:

    Download the latest version of the SuperDDNS Updater for Linux:

    wget https://www.superddns.net/downloads/linux/updater/setup.sh


    Step 2:

    Next, set the execute permission on the script you just downloaded.

    chmod +x setup.sh


    Step 3:

    Now we execute the script using sudo, or as root with the --install parameter.

    sudo ./setup.sh --install


    Step 4:

    Enter your UserID.


    Step 5:

    Enter the HostID you wish to update.


    Step 6:

    Choose your update interval in minutes. 5 miniutes is the minimal value for free accounts, see this knowledge base article for more information.


    Step 7:

    The installation is complete. Next we will need to test the configuration.


    Step 8:

    Let's launch the updater with the -i interactive mode parameter to make sure it is updating your Hostname successfully.

    sudo /opt/superddns-updater/updater.sh -i


    Step 9:

    If you see the message "Updated Successfully," then you are ready to start the updater service.

    sudo systemctl start superddns-updater.service


    Step 10:

      And finally, let's check the service status.

    sudo systemctl status superddns-updater.service



    Additional Parameters

    Usage: setup.sh < parameter >

    --install

    Installs the SuperDDNS Updater as a service on your system.

    --uninstall

    Uninstalls the SuperDDNS Updater service from your system.

    -i

    Interactive mode launches the SuperDDNS Updater as a command-line application with live display of update results.

    -b

    Background mode runs the SuperDDNS Updater as a background process.

    -c

    Configuration mode prompts you for your UserID, HostID, and update interval.




    File Locations

    The SuperDDNS Updater stores data in the following locations:

    Log File

    /var/log/superddns-updater.log

    Configuration File

    /etc/superddns-updater/options.conf

    Installation Directory

    /opt/superddns-updater/