“The IP address is not routable” in Network settings on Mac

The address that you typed is in a range that the Mac cannot route, such as a link-local range. macOS asks for a different one.

Fix this with your agentCopies a prompt for Claude Code, Codex or any agent that can use Terminal.

My Mac has this problem: “The IP address is not routable” in Network settings on Mac. Read https://kilobat.app/guides/ip-address-not-routable.md and work through it with me. Install the Kilobat CLI if it’s missing: brew install seifip/kilobat/kilobat. Run the guide’s Terminal and kilobat checks yourself and tell me what you find. List the steps only I can do. Ask before you change any setting.

Applies to: All current macOS versions. The text was checked in Network settings on macOS 27.2.Checked: 29 October 2026

Symptoms

  • An alert says “The IP address is not routable. It is recommended that a different IP address be entered.”
  • The address starts with 169.254.
  • You set Configure IPv4 to Manually.

Likely causes

  • A link-local address. Addresses that start with 169.254 are for the local link only.
  • An address that does not fit the subnet. The address and subnet mask do not match the router.
  • A value from a self-assigned address. You copied the address that the Mac gave itself.

How to check

  1. Show the address now.

    ifconfig en0
  2. Look at the Router and Subnet Mask fields in System Settings › Network › Details › TCP/IP.

How to fix it

  1. Set Configure IPv4 to Using DHCP. See Mac has a self-assigned IP address.

  2. For a fixed address, use one in the subnet of the router, outside the DHCP range.

  3. Renew the lease. See Renew the DHCP lease on a Mac.

Questions

Why is 169.254 not routable?

Routers do not forward these addresses. The Mac gives them to itself when DHCP fails.

Can I ignore the alert?

macOS only recommends another address. A fixed address that the router cannot route will not reach the internet.

Sources

  • Error text in Network.appex (System Settings), macOS 27.2 (Localizable.loctable)
  • ifconfig(8), man page installed with macOS 27.2

Checked on 29 October 2026.