Awala Ping for Desktop
The Awala Ping for Desktop is a CLI implementation of the Awala Ping Service, which is meant to help test Awala itself.
This document is aimed at advanced users and (prospective) contributors. To learn more about using Awala in general, visit awala.network/users.
This tool is available as the NPM package
@relaycorp/awala-ping. To install it globally, run:
npm install -g @relaycorp/awala-ping
To send a ping, run:
The command above will wait until the pong message is received.
Sending pings to custom endpoints
By default, the
ping subcommand will communicate with the public endpoint at
ping.awala.services. If you wish to use a different endpoint, you need to:
- Download the identity certificate for the public endpoint with which you want to communicate.
- Import the endpoint first with the
third-party-endpoints import-publicsubcommand. For example:
awala-ping third-party-endpoints import-public < /path/to/connection-params.der
- Specify the Internet address of your custom endpoint when you send pings. For example:
awala-ping ping your-endpoint.com
Registering with the private gateway
By default, the
ping subcommand will register with the Awala Gateway for Desktop if the app hasn't been registered yet. To register explicitly, run:
Each registration will create an Awala endpoint internally. The latest endpoint to be created will become the default one.
Security and privacy considerations
The items below summarize the security and privacy considerations specific to this app. For a more general overview of the security considerations in Awala, please refer to RS-019.
No personally-identifiable information is stored
This app only stores cryptographically-generated data whose inputs are not derived in any way from personally-identifiable information.
This app only communicates with the following:
- The private gateway.
- Any public endpoint that the user sends pings to. By default, the Relaycorp-operated public endpoint at
This app doesn't track usage (for example, using Google Analytics), nor does it use ads.
To install this app in development, simply run
npm install from the root of the repository.
To run a subcommand in the CLI, pass the subcommand name to the command
npm run run --. For example, to send a ping, run:
npm run run -- ping
We love contributions! If you haven't contributed to a Relaycorp project before, please take a minute to read our guidelines first.