Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

View on Docker Hub

View on GitHub

Local Address DNS Client (RPi)

What is this?

This is a web service (written in NodeJS) that responds with a JSON result containing your devices IP address on a local network interface.

This responds in the form:

	ip : [local ip address]

This is used by local-address-dns. local-address-dns is run on an internet facing (IP address known) server. You don't always know the IP address your Raspberry Pi will be assigned on your local network (and don't always have access to / can be bother with MAC based DHCP assignments). local-address-dns turns a DNS entry like into your local IP address.

Your Pi must be able to be accessed from the internet facing machine, such as via a VPN connection. local-address-dns-client-rpi runs on your Pi to provide your IP address to local-address-dns. local-address-dns runs a DNS server that responds with the local address of the Pi.

For more information about the inspiration and implementation, see my blog post, Easy access to my Pi on a local network.

Determining the interface to use

Fill in interface with the network interface that you would like to get the IP address for (e.g.: eth0). Use ifconfig to list all your available interfaces.

Using Docker


Build with docker build -t jordancrawford/local-address-dns-client-rpi ..


Run with docker run -d -p 3000:3000 --restart always --name local-address-dns-client --net=host jordancrawford/local-address-dns-client-rpi [interface]

Using Directly

Ensure NodeJS is installed on your system and run: node client [interface]. The server is available at port 3000.


A web server that provides the IP address of a local network interface.



No releases published


No packages published
You can’t perform that action at this time.