What is home-location-endpoint?

This project turns a Linux server into an endpoint that changes what location Apple's network based location system reports back to an iPhone. It intercepts the specific Apple location lookup traffic, figures out what city the server's public IP address is in, then picks a random point within that city's real boundaries to report instead of the server's own coordinates. Regular internet traffic through the server is not affected by this location rewriting. The installer offers three modes. A beginner mode sets up both the location changer and a bundled proxy connection automatically. An intermediate mode, which the project recommends, adds the same setup plus a Telegram bot that lets you switch between multiple preset city locations, restore your real location, and receive connection details through chat messages. An advanced mode installs only the location changing component, leaving the proxy setup entirely to the user. Setup is a single command that downloads and runs an install script, with options to run the whole process without any interactive prompts by passing environment variables and command line flags. After installation, the tool generates a connection link, a certificate profile to install on the iPhone, and a fingerprint to verify that certificate. The phone downloads and trusts this certificate so it can talk through the server, then the user turns on the appropriate proxy or VPN mode. The project is explicit about its limits. Apple can still learn a phone's real location from other signals such as nearby WiFi networks, cellular data, GPS, or account level information, since this project only changes the response to Apple's WiFi based network location requests. It does not claim to hide location from every possible source, and warns that installing a private security certificate increases what the device has to trust, though the certificate's private key is deleted immediately after use. The README describes this as an early stage project meant for testing on non critical devices, not for emergency services, anti theft features, or safety critical uses. It targets technical users comfortable running server commands who want to control what location their iPhone reports over the network.