How do I set a static IP address?

Most routers use DHCP to automatically assign an IP address to your TinyPilot. Under DHCP, TinyPilot receives whatever IP address the router has available, and this IP address may change.

In some cases, it's helpful to configure your TinyPilot with a static IP address. A static IP address does not change, even if you reboot your TinyPilot or your router.

Setting up a static IP address

To set up a static IP address, SSH in to the Tinypilot and specify the settings for your network:

export TINYPILOT_STATIC_IP="10.0.0.223/24" # Set to your desired IP address / netmask
export ROUTERS="10.0.0.1"                  # Set to your router's IP address
# Choose your preferred DNS settings. The default DNS setting (below) queries
# your router's DNS, then Google (8.8.8.8), then Cloudflare (1.1.1.1).
export DNS="${ROUTERS} 8.8.8.8 1.1.1.1"

Once you have specified your settings, run the following commands to apply the static IP address:

curl --fail --silent --show-error \
  https://tinypilotkvm.com/scripts/set-static-ip.sh | /bin/bash && \
  sudo reboot

Removing a static IP address

To revert the changes above and use DHCP instead of a static IP address, run the following commands:

unset TINYPILOT_STATIC_IP

curl --fail --silent --show-error \
  https://tinypilotkvm.com/scripts/set-static-ip.sh | /bin/bash && \
  sudo reboot