TrueNAS AppsTrueNAS Apps: Tutorials
Application maintenance is independent from TrueNAS version release cycles.
App versions, features, options, and installation behavior at time of access might vary from documented tutorials and UI reference.

DDNS-Updater

Documentation for applications within the Community train is created and maintained by members of the TrueNAS community. The TrueNAS Documentation Hub hosts but does not validate or maintain articles within this section.

Community contributions are highly encouraged! Please see Contributing to TrueNAS Application Documentation to learn how you can assist.

Needs Improvement
This community application tutorial is suspected to be out of date or inaccurate. Please help the TrueNAS community improve it or discuss these issues in the TrueNAS Community forum.

The DDNS-Updater application is a lightweight universal dynamic DNS (DDNS) updater with web UI. When installed, a container launches with root privileges in order to apply the correct permissions to the DDNS-Updater directories. Afterwards, the container runs as a non-root user.

We welcome community contributions to keep this documentation current! Click Edit Page in the top right corner to propose changes to this article. See Updating Content for more information.

First Steps

Make sure to have account credentials ready with the chosen DNS provider before installing the application in TrueNAS.

Supported Providers (Click to expand)
Provider
Aliyun
All-Inkl
Cloudflare
DD24
DDNSS
Digital Ocean
DNS O Matic
DNS Pod
Don Dominio
Dreamhost
Duck DNS
DynDN
Dynu
DynV6
FreeDNS
Gandi
GCP (Google Cloud Services Platform)
GoDaddy
Google
He.Net
Infomaniak
INWX
Linode
LuaDNS
Namecheap
Njalla
NoIP
OpenDNS
OVH
Porkbun
Selfhost.De
Servercow
Spdyn.De
Strato
Variomedia

To grant access to specific user (and group) accounts other than using the default apps user (UID: 568), add a non-root TrueNAS administrative user from Credentials > Local Users and record the UID and GID for this user. Using a non-default user/group account forces permissions changes on any defined data storage for this application.

Have the TRUENAS catalog loaded and community train enabled. To view and adjust the current application catalogs, go to Apps and click Discover Apps > Manage Catalogs.

Configuring the Dynamic DNS Service Application

Go to Apps, click Discover Apps, and locate the DDNS-Updater application widget by typing the first few characters of the application name in the search bar.

Finding the DDNS-Updater Application
Figure 1: Finding the DDNS-Updater Application

Click the application card to see additional details about the application and options to install it.

DDNS-UpdaterApplication Details
Figure 2: DDNS-Updater Application Details

Click Install to open the DDNS-Updater configuration screen. Application configuration options are presented in several sections. Find specific fields or skip to a particular section with the navigation box in the upper-right corner.

Install DDNS-Updater Screen
Figure 3: Install DDNS-Updater Screen

Application Name

DDNS Updater Configuration

Select the timezone that applies to the TrueNAS location from the Timezone dropdown list.

Click Add to the right of DNS Provider Configuration to display provider setting options. Select the DDNS provider from the Provider dropdown list. Each provider displays the settings required to establish a connection with and authenticate to that specific provider.

DDNS-Updater Add DNS Provider Configuration
Figure 4: Add DDNS-Updater Provider Configuration

Enter the domain and host name split between the Domain and Host fields. For example, populate domain myhostname.ddns.net with ddns.net in Domain and myhostname afer the @ in Host or @myhostname. Define how often to check IP addresses with Update Period and Update Cooldown Period. The application also creates .zip backups for the data/config.json and data/updates.json files according to a defined schedule in Backup Period. Define the HTTP request and DNS query time out values with HTTP Timeout and PUblic IP DNS Timeout.

To configure notifications with the Shoutrrr service, click Add and enter the service Address under Shoutrrr Addresses.

Use the Public IP options to define which providers to use for the various DNS, IPv4, and IPv6 public addresses. The default All providers allows for quick app usability but these options can be tuned as needed.

User and Group Configuration

By default, the TrueNAS apps (UID/GID 568) user and group account manages this application.

DDNS-Updater User and Group Configuration
Figure 5: DDNS-Updater User and Group Configuration

Entering an alternate UID or GID reconfigures the application to run as that account. When using a custom account for this application, make sure the account is a member of the Builtin_administrators group and that the storage location defined in Storage Configuration has permissions tuned for this account after the application is installed.

Network Configuration

By default, this application uses TrueNAS port 30007 to access the application web interface.

DDNS-Updater Network Configuration
Figure 6: DDNS-Updater Network Configuration

Adjust the Web Port integer when a different network port is required. Select Host Network to bind to the host network, but we recommend leaving this disabled.

Storage Configuration

DDNS-Updater Storage Configuration
Figure 7: DDNS-Updater Storage Configuration

Select the DDNS Updater Data Storage option from the Type dropdown list. Options are the iXVolume or a predefined host path.

Resources Configuration

By default, this application is limited to use no more than 4 CPU cores and 8 Gibibytes available memory. The application might use considerably less system resources.

DDNS-Updater Resource Configuration
Figure 8: DDNS-Updater Resource Configuration

Tune these limits as needed to prevent the application from overconsuming system resources and introducing performance issues.

Review the configuration settings then click Install for TrueNAS to download and initialize the application.