RIPE Atlas Tools (Magellan)

November 25, 2025 · View on GitHub

The official command-line client for RIPE Atlas.

Examples

Configure API key for creating measurements::

$ ripe-atlas configure --set authorisation.create=MY_API_KEY

Ping an IP address from five probes::

$ ripe-atlas measure ping ping.ripe.net --probes 5

.. image:: screenshots/ripe-atlas-measure-ping.png

Search for connected probes in Germany, grouping by ASN::

$ ripe-atlas probe-search --country de --aggregate-by asn_v4 --limit 10

.. image:: screenshots/ripe-atlas-probe-search.png

Search for NTP measurement metadata and process the results with awk::

$ ripe-atlas measurement-search --type ntp --format tab --no-header --limit 5 \
  | awk -Ft '{printf "#%s (%s)\n", \$1, \$3}'

.. image:: screenshots/ripe-atlas-measurement-search.png

Can I Contribute?

Absolutely. Please read our guide_ on how to contribute.

This project was code-named by means of a poll_. In order to conform to the RIPE Atlas theme, it had to be named for an explorer, and so the winning suggestion was for Magellan, "in memory of those times when RTT was ~3 years".

.. |Documentation| image:: https://readthedocs.org/projects/ripe-atlas-tools/badge/?version=latest :target: http://ripe-atlas-tools.readthedocs.org/en/latest/?badge=latest :alt: Documentation Status .. _ReadTheDocs: https://ripe-atlas-tools.readthedocs.org/ .. _guide: https://github.com/RIPE-NCC/ripe-atlas-tools/blob/master/CONTRIBUTING.rst .. _poll: https://github.com/RIPE-NCC/ripe-atlas-tools/issues/13 .. |PYPI Version| image:: https://img.shields.io/pypi/v/ripe.atlas.tools.svg :target: https://pypi.org/project/ripe.atlas.tools/ .. |Python Versions| image:: https://img.shields.io/pypi/pyversions/ripe.atlas.tools.svg .. |Python Implementations| image:: https://img.shields.io/pypi/implementation/ripe.atlas.tools.svg .. |Python Format| image:: https://img.shields.io/pypi/format/ripe.atlas.tools.svg

RIPE Atlas Tools (Magellan)

Full Documentation

Examples

Can I Contribute?

Colophon