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.

This feature requires at least TinyPilot Community 1.8.1 or TinyPilot Pro 2.5.2.

Setting up a static IP address

Warning: If you set incorrect values for your static IP address, you will no longer be able to access your TinyPilot over the network. You'll need to perform a factory reset to regain access to your device.

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

TINYPILOT_STATIC_IP="" # Set to your desired IP address / netmask
ROUTERS=""                  # Set to your router's IP address
# Choose your preferred DNS settings. The default DNS setting (below) queries
# your router's DNS, then Google (, then Cloudflare (

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

/opt/tinypilot-privileged/scripts/set-static-ip \
  --router "${ROUTERS}" \
  --dns "${DNS}" && \
  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:

/opt/tinypilot-privileged/scripts/unset-static-ip && \
  sudo reboot