Go to the content

Contribute

Our IXmapsClient contribution tool is experiencing some issues at the moment. You may not be able to successfully submit new routes until these issues are resolved. Thank you for your understanding.

In the meantime, you might want to check out the Canadian Traceroute Database (CTRD) being developed by CIRA based on IXmaps.

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.

Update

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.

Windows
Download
This version of the software runs on Windows 10. IXmapsClient needs to be executed in a terminal with administrator's privileges. For this reason, when double clicking IXmapsClient-Shortcut, a new terminal window will be opened asking permission to run the application as an administrator; you may need to enter your admin password to proceed. The IXmapsClient interface should appear in your browser, or use your browser to go http://localhost:2040/.

Removing IXmapsClient
Mac OSX
Download

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


Linux
Download

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.