TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 24.04 (Dragonfish) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

DDNS-Updater

Application maintenance is independent from TrueNAS SCALE version release cycles. This means app version information, features, configuration options, and installation behavior at the time of access might vary from those in documented tutorials.

In TrueNAS 24.04 (Dragonfish), the Apps feature is provided using Kuberenetes. To propose documentation changes to a Kubernetes-based app available in TrueNAS 24.04 (Dragonfish), click Edit Page in the top right corner.

Future versions of TrueNAS, starting with 24.10 (Electric Eel), provide the Apps feature using Docker. To propose documentation changes for a separately versioned Docker-based app, first use the Product and Version dropdowns to switch to the Nightly version Apps documentation, then click Edit Page.

See Updating Content for more guidance on proposing documentation changes.

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.

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

Leave these fields at their default settings. Changing the application version is only recommended when a specific version is required.

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.