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 TinyPilot Pro 2.6.3 or later.

To set a static IP address through the web UI, navigate to the static IP address menu by going to System > Networking > Static IP.

A screenshot of TinyPilot's web interface. The 'system' menu is open, along with the 'Networking' submenu. The 'Networking' submenu shows 'Static IP' highlighted. A red arrow points to the 'Static IP' menu item.

Navigate to the Static IP dialog in TinyPilot's web interface to set a static IP address.

In the Static IP dialog, enter your desired static IP address, your netmask, and your router's IP address, then click "Apply Static IP."

To remove a static IP address, navigate to the Static IP menu and click "Remove Static IP."

Assigning a static IP address via command-line interface (deprecated)

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 via command-line interface (deprecated)

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