Contributing to the IXmaps database anonymously
IXmaps relies on voluntary contributions of anonymized traceroute data. We invite you to join over 1000 other contributors who have helped to grow the database to well over 500,000 traceroutes. The more distinct the originating points, in terms of both city and ISP, and the more varied the destination targets, the better able we are to display interesting internet routings.
Contributing data involves installing traceroute generating software built by the IXmaps development team. It initiates traceroute requests from your location either at batches of pre-selected target sites, or at individual hostnames (like URLs) of your choosing. You can view the traceroutes you and others have contributed via the Map page.
To ensure the anonymity of contributors, we do not store the IP address of your personal device, but only a truncated version, with the last quad zeroed out. eg. 127.123.123.0. To verify this and any other features of this software, check out our free and open source code on GitHub.
You should be aware that in order to work effectively, the traceroute generation software needs access to low-level (e.g. "socket layer") functions of your computer. Read carefully the ReadMe document that comes with the download package before installing and running the software. See our Privacy page, for more on how we anonymize your IP address and protect your privacy.
As of August 30th, 2020, IXmapsClient version 1.0.6 will no longer function correctly. Please download IXmapsClient 1.1.1 to continue to contribute to this project.
Installing and running the IXmaps Client
IXmapsClient works on Windows, Mac OS X, and Linux.
WindowsDownload This version of the software runs on Windows 10.
- Download the IXmapsClient installer IXmapsClient.1.1.1.win64.exe
- Double click on IXmapsClient.1.1.1.win64.exe and install the application in the directory C:\IXmapsClient
- Copy the IXmapsClient-Shortcut to your Desktop
- In order to allow the IXmapsClient to run properly, you may need to authorize Windows Firewall to allow inbound connections. For a detailed guide on how to change these settings, see the included README file
- Double click on IXmapsClient-Shortcut to launch
- Run C:\IXmapsClient\unins000.exe to completely remove IXmapsClient from your machine
- Download the IXmapsClient installer IXmapsClient.1.1.1.macos.dmg
- Double click on the IXmapsClient.1.1.1.macos.dmg to open it
- Drag the IXmapsClient.app application to your Applications folder
- Double click on IXmapsClient.app to launch
IXmapsClient for macOS is not signed with an Apple Developer ID and macOS Gatekeeper security settings will not allow it to be started. To bypass Gatekeeper one time for IXmapsClient, control-click or right-click on the IXmapsClient.app icon and choose Open from the context menu.
If you have upgraded to OSX Catalina, you may experience further challenges getting the IXmapsClient to work correctly on your machine. It has been tested on Catalina and is confirmed to work, but you may need to approve multiple libraries in Settings - Security & Privacy. We are working to resolve this issue, please bear with us!
IXmapsClient needs to be executed in a terminal with administrator's privileges. For this reason, make sure to use an Administrator user account instead of a Standard user account when running IXmapsClient. When double clicking IXmapsClient.app, a new terminal window will be opened asking for the administrator's password; you may need to enter your admin password to proceed. The IXmapsClient interface should appear in your browser, or use your browser to go to http://localhost:2040/.Removing IXmapsClient
Move the IXmapsClient.app application from your Applications folder to the Trash. Emptying the trash will completely remove the IXmaps Client from your computer
- Download the IXmapsClient installer IXmapsClient.1.1.1.linux.tar.gz
- Extract the contents of the file IXmapsClient.1.0.6.linux.tar.gz, e.g. with the Linux Archive Manager or by running the following command in a terminal window: tar xzvf IXmapsClient.1.1.1.linux.tar.gz
- Run ./start.sh in the terminal to launch the application
IXmapsClient needs to be executed in a terminal with administrator's privileges. For this reason, when executing IXmapsClient, a new terminal window will be opened asking for the administrator's password; you may be required to enter your admin password to proceed. The IXmapsClient interface should then be shown in a new browser window, or use your browser to go http://localhost:2040/.Removing IXmapsClient
Delete the IXmapsClient folder. In a Linux terminal window, navigate to the directory where IXmapsClient resides, then you run the following command: rm -r IXmapsClient This will completely remove the IXmapsClient from your computer.
Other welcome contributions
Correcting the location of routers
Locating accurately the individual routers that switch data packets along the way to their destination is challenging. You may find when examining traceroutes displayed on the Map page that some routers appear out of place, sometimes even wildly. We invite you to use the Flag option to point these out and suggest more accurate locations for the IP addresses of such routers so we can correct it later. This can be done by clicking on the routers (dots) or hops (lines), and then the appropriate Flag button. Any information you provide about why you think the router location is inaccurate, and where it is more likely to be, is helpful in making corrections. See our FAQ page for more on geolocation.
Improving our software
While we do our best to ensure that our software operates reliably and safely, and is easy to use, this is not a polished, high-end application, but rather the latest product of a on-going, unevenly funded research project. If you encounter difficulties or see obvious areas for improvement, please be patient and let us know what needs to be improved. Or better, if you have the skills, make the improvements yourself! The code used for gathering traceroutes, as well as the code for the website and various related components, is free and open source, and available from our GitHub repositories.
We welcome all feedback (critical and appreciative), technical inquiries or offers for assistance regarding IXmaps software, database, or website. Please email the IXmaps team.