Getting started

Hostnames are provisioned by SoMo Technologies. If you are a customer, you will receive a portal invitation and the hostname(s) for your sites.

1. Get a hostname and a credential

Each hostname belongs to one site of one organization, for example acme-main.ddns.justasrv.com. In the portal, open the hostname and choose Generate under Credentials. The token (it starts with jas_) is shown once. Copy it into your password manager or straight into the device.

Use one credential per device. If a router is replaced or compromised, revoke just its token.

2. Test from any computer at the site

curl -u 'acme-main.ddns.justasrv.com:jas_YOUR_TOKEN' \
  'https://ddns.justasrv.com/nic/update?hostname=acme-main.ddns.justasrv.com'

A response of good 203.0.113.10 or nochg 203.0.113.10 means it worked. The address is the one your request came from.

Run the test from the site. Running it from your office publishes your office's address for the customer's hostname, which the next update from the site corrects.

3. Configure the device that will keep it updated

Pick the guide for the site's firewall: pfSense, OPNsense, MikroTik, UniFi, OpenWrt. If the firewall cannot use a custom provider, install the Windows or Linux updater on an always-on machine at the site.

4. Confirm in the portal

The hostname shows ONLINE with the current address and the time of the last update. Resolve it from anywhere:

nslookup acme-main.ddns.justasrv.com 1.1.1.1

5. Set the right status thresholds

Updaters that send a heartbeat (the JustASRV updaters, the MikroTik and OpenWrt configurations in these docs) keep the default thresholds: STALE after 30 minutes, OFFLINE after 24 hours. Firewalls that only report changes (pfSense, OPNsense) check in rarely by design, so an administrator sets longer thresholds on that host. Each guide lists the values.