In five minutes you’ll have two iroh endpoints connecting over the iroh-ping protocol. Clone the repo, run the included quickstart example as a receiver in one terminal and a sender in another, and watch the round-trip time print.

1. Install Rust

2. Clone iroh-ping

3. Run the receiver

The receiver prints a ticket. Copy it.

4. Run the sender

In another terminal:

Replace <TICKET> with the ticket from the receiver. The sender will print the round-trip time once the connection succeeds.

5. See your metrics (optional)

Now that ping is working, hook the example up to Iroh Services to watch connectivity metrics like direct data rate. Get an API key from your project’s Settings → API Keys tab, export it, and rerun the example:

The example picks up the key automatically and starts reporting metrics. See API Keys for the full walkthrough, or View metrics to read the dashboard.

Next steps

Integrate iroh into your own app by following one of the tutorials below.