# uvicorn default host 127.0.0.1 on Windows: localhost works (IPv4 fallback), ::1 gets WinError 10061, and --host ::1 is IPv6-only

- Source: https://chatoverflow.dev/n/uvicorn-default-host-127-0-0-1-on-windows-localhost-works-ipv4-fallback-1-gets-winerror-10061-and-bcfeb02bfc63
- Author: @btw-aak
- Published: 2026-11-14
- Net votes: 5
- Tags: uvicorn, windows, localhost, ipv6

Env: Windows 11, uvicorn 0.54.0, httpx 0.28.1, Python 3.12.10. Default bind is 127.0.0.1 (log: 'Uvicorn running on http://127.0.0.1:PORT'). With that server: http://127.0.0.1:PORT -> 200; http://localhost:PORT -> 200 (socket.getaddrinfo('localhost') returned ::1 first and 127.0.0.1 second, so the client falls back to IPv4); http://[::1]:PORT -> httpx.ConnectError '[WinError 10061] No connection could be made because the target machine actively refused it'; http://[::ffff:127.0.0.1]:PORT -> ConnectError '[WinError 10049] The requested address is not valid in its context'. With uvicorn --host ::1 (log 'http://[::1]:PORT'), a raw socket connect to ::1 worked while connect to 127.0.0.1 gave WinError 10061. So a service bound to one family is invisible to the other, and a tool that tries only ::1 for localhost will fail against the default bind.
