Router DDNS Configuration Guide

Getting Started

Step 1: Create Your LockIP Account

  1. Visit www.lockip.net
  2. Click "Sign Up" in the top right corner
  3. Fill in your details:
    • Choose a username (you'll use this for router login)
    • Enter your email address
    • Create a strong password
    • Provide your first and last name
  4. Complete the CAPTCHA verification
  5. Accept the Terms of Service and Privacy Policy
  6. Click "Create Account"

Step 2: Add Your Domain

  1. Log in to your LockIP account
  2. From the Dashboard, click "+ Add Domain"
  3. Configure your domain:
    • Subdomain: Enter your desired name (e.g., "home", "myrouter")
    • Zone: Select from available zones (e.g., lockip.net)
    • Record Type: Choose A for IPv4 or AAAA for IPv6
    • Initial IP: Leave blank (router will update automatically)
  4. Click "Add Domain"
  5. Note your full domain name (e.g., home.lockip.net)

Important: Remember your username and password - you'll need these to configure your router.

Router Configuration

Ubiquiti UniFi Routers

⚠️ Important: The "afraid" service option in UniFi routers may not work as it appears to be hardcoded to send updates to afraid.org servers. Use the "Custom" or "dyndns" option instead as shown below.

In your UniFi Network application:

  1. Go to SettingsInternetDynamic DNS
  2. Click "Create New Dynamic DNS" or "+"
  3. Configure using one of these methods:

Option 1: Custom Service (Recommended)

  • Service: Select custom or dyndns
  • Hostname: Your full domain (e.g., home.lockip.net)
  • Username: Your LockIP username
  • Password: Your LockIP password
  • Server: www.lockip.net/nic/update
  • Check Interval: 600 seconds (10 minutes)

ASUS Routers

  1. Go to WANDDNS tab
  2. Configure:
    • Enable DDNS Client: Yes
    • Server: Custom
    • Host Name: Your full domain
    • User Name: Your LockIP username
    • Password: Your LockIP password
    • URL:
https://www.lockip.net/nic/update?hostname=<domain>&myip=<ipaddr>

DD-WRT

  1. Go to SetupDDNS
  2. Configure:
    • DDNS Service: Custom
    • DYNDNS Server: www.lockip.net
    • Username: Your LockIP username
    • Password: Your LockIP password
    • Hostname: Your full domain
    • URL: /nic/update?hostname=

OpenWRT

Edit /etc/config/ddns:

config service 'lockip'
    option enabled '1'
    option interface 'wan'
    option service_name 'custom'
    option update_url 'https://[USERNAME]:[PASSWORD]@www.lockip.net/nic/update?hostname=[DOMAIN]&myip=[IP]'
    option domain 'home.lockip.net'
    option username 'your_username'
    option password 'your_password'
    option check_unit 'minutes'
    option check_interval '10'

pfSense

  1. Go to ServicesDynamic DNS
  2. Click "Add" to create new client
  3. Configure:
    • Service Type: Custom
    • Interface: WAN
    • Hostname: Your full domain
    • Username: Your LockIP username
    • Password: Your LockIP password
    • Update URL:
https://www.lockip.net/nic/update?hostname=%HOST%&myip=%IP%

Supported Update Endpoints

LockIP supports multiple DDNS update protocols for maximum compatibility:

Primary Endpoints (Recommended)

  • /nic/update - DynDNS2/afraid.org compatible
  • /api/domains/nic/update - Full path version

Alternative Endpoints (Legacy Support)

  • /v2/update - DynDNS2 alternative
  • /dyndns/update - Legacy DynDNS
  • /api/domains/update - Original LockIP format

All endpoints support both GET and POST methods with HTTP Basic Authentication.

Testing & Troubleshooting

Test Your Configuration

Test manually with curl:

# Test with specific IP
curl -u username:password \
  "https://www.lockip.net/nic/update?hostname=home.lockip.net&myip=1.2.3.4"

# Test with auto-detected IP
curl -u username:password \
  "https://www.lockip.net/nic/update?hostname=home.lockip.net"

Response Codes

Your router will receive these standard responses:

  • good [IP] - Update successful
  • nochg [IP] - IP unchanged (no update needed)
  • badauth - Authentication failed
  • nohost - Domain not found
  • dnserr - DNS update error

Need Help?

If you're still having issues configuring your router: