.. no-ip_client:


.. _chapter_no-ip_client:

NO-IP Client
============

See `no-ip Dynamic Update Client <https://my.noip.com/dynamic-dns/duc>`__ of how to install a Linux Dynamic Update Client. The VPN is used to link the url **dingx.gotdns.ch** to a VM.

The **Dynamic Update Client** (=DUC) runs on the VM and checks frequently for an IP address change. When a different IP address is detected, the DUC automatically updates the hostname to the correct IP address.

1. Download and install the Linux DUC in terminal
----------------------------------a---------------

   .. code:: 

      cd /usr/local/
      sudo wget https://www.noip.com/download/linux/latest
      sudo tar xf latest
      cd noip-duc_3.1.0/binaries 
      sudo apt install ./noip-duc_3.1.0_amd64.deb

2. Once installed, run the following to start the program
---------------------------------------------------------

   .. code:: 

      noip-duc

3. To login and send updates using DDNS Keys enter the following
----------------------------------------------------------------

   .. code:: 

      noip-duc -g all.ddnskey.com --username <DDNS Key Username> --password <DDNS Key Password>

   Example:

   .. code:: 

      noip-duc -g dingx.gotdns.ch --username fmoehring --password PASSWORD --check-interval 15m

For PASSWORD see :keepass:`KeePass<>`.

4. Configuration
----------------

   The file `/etc/default/noip-duc` contains the configuration of the service:

   .. code:: 

      sudo nano /etc/default/noip-duc

   Example:

   .. code:: 

      sudo nano /etc/default/noip-duc

      ## File: /etc/default/noip-duc
      NOIP_USERNAME=fmoehring
      NOIP_PASSWORD=PASSWORD
      NOIP_HOSTNAMES=dingx.gotdns.ch
      NOIP_HOSTNAMES=django.gotdns.ch
      NOIP_HOSTNAMES=logistics.gotdns.ch

   For PASSWORD see :keepass:`KeePass<>`.

5. Daemon
---------

   For the installation of a Job on Debian Linux see: `Running the Linux DUC v3.0 at startup <https://www.noip.com/support/knowledgebase/running-linux-duc-v3-0-startup-2>`__. The job **noip-duc.service** has been installed in "/etc/systemd/system" and is active. The job starts the service with the configuration defined in `/etc/default/noip-duc`.

   Install the service:

   .. code:: 

      sudo nano /etc/systemd/system/noip-duc.service

   Content of the service:

   .. code:: 

      [Unit]
      Description=No-IP Dynamic Update Client
      After=network.target auditd.service

      [Service]
      EnvironmentFile=/etc/default/noip-duc
      ExecStart=/usr/bin/noip-duc
      Restart=on-failure
      Type=simple

      [Install]
      WantedBy=multi-user.target

   Reload the systemd daemon:

   .. code:: 

      sudo systemctl daemon-reload

   Enable the service:

   .. code:: 

      sudo systemctl enable noip-duc

   Start the service:

   .. code:: 

      sudo systemctl start noip-duc

   Status of the service:

   .. code:: 

      sudo systemctl status noip-duc