sahilll15/netdoctor

Netdoctor is a command line tool for diagnosing why a server or website cannot be reached. Instead of manually running several different commands one after another the way an experienced engineer would, checking whether a name resolves, pinging it, checking if a specific port is open, then trying to load it over the web, netdoctor runs that whole sequence automatically and reports back a single, readable diagnosis of exactly which step failed. Point it at any host, for example a website address or an internal database address with a port number, and it walks through domain name lookup, a network ping, a check of the relevant port, and finally an actual web request, showing the result of each step along with how long it took. It is smart enough to know that a failed ping does not necessarily mean a server is down, since many production servers are configured to ignore pings on purpose, so it weighs the port and web checks as more meaningful signals of whether something is actually working. Beyond the basic check, it can also trace the network path a request takes hop by hop, watch a host continuously in a live dashboard, check several servers at once, and output results in a machine readable format for use in automated scripts or monitoring pipelines. It installs through several common methods depending on your setup, including pipx, Homebrew, Docker, or downloading a ready made program file with no need to install Python at all. It also publishes packages automatically whenever a new version is tagged. The project is written in Python, is open source under the MIT license, and is aimed at developers, operations engineers, and anyone who needs a fast, plain English answer to the question of why a service will not load.