JetStream URI Scheme


JetStream Clients can be controlled using a jetstream: URI scheme. Any JetStream URIs should conform to RFC 3986.

The JetStream URI is defined as jetstream://authority/action/path?query#anchor:


When addressing a specific server, authority can be expressed as a hostname, ip, and optional port number, referring to the JetStream server and API port. If port number is not specified, JetStream default 8886 is assumed. The address and port must be specified as defined in Section 3.2 of RFC 3986. Please note that JetStream Clients will ignore the user infomration portion of the URI.


  • jetstream://
  • jetstream://
  • jetstream://
  • jetstream://

When the authority is left blank, the recipient of the action is the JetStream client itself, and must start with three slashes (///).

For example

  • jetstream:///

Action defines the task the JetStream client should do. The action can optionally be slash (/) terminated.


  • jetstream://
  • jetstream://
Unused, and reserved for future use.

Percent-encoded key=value pairs, separated by ampersand (&). Actions may require specific key-value pairs to be present.


  • jetstream://
  • jetstream://
Unused, and reserved for future use.

Supported Actions


Connect to the server specified in authority. The authority section must not be blank.

For example, jetstream:// would cause a client to start up and automatically connect to the JetStream server on port 8886 (default).


Connect to the JetStream server specified in authority, and initiate download of shared link specified by the token key-value pair given in query. The authority section must not be blank.

For example, jetstream://, would cause the JetStream Client to connect to and attempt to download a shared link identified by token TO.K.EN.

Example Uses

The JetStream URI schema can be used to simplify 3rd party client setup by directing users to a web address redirection, which will prompt the user to start the JetStream Client application, and connect to the given server.

Simple Redirect Setup

Let’s assume an organization has a website at, and we want our users to connect to JetStream server.

The web server administrator could setup the web server to redirect to jetstream:// We can then email this HTTP link to the organization’s users. When a user, who already has a JetStream Client installed, browses to the link, the JetStream Client will pop up and connect to the server automatically. For first-time connections, the user will be prompted for username and password.

Unfortunately, users without a JetStream Client won’t be notified in any way. For a more universal solution, see the File Redirect Setup below.

File Redirect Setup

Expanding on the Simple Redirect Setup example above, the web server administrator could publish a simple html file, that will handle the redirection. Let’s assume the following file is published at

      <meta http-equiv="refresh" content="1; URL=jetstream://" />
      <title>Connecting to</title>
      <h1>Connecting to</h1>
      <p>You will be prompted to open the JetStream Client application momentarily. If you're connecting for the first time, you will be prompted for username and password once JetStream Client starts.</p>
      <p>If you don't have the JetStream Client, please <a href="" target="_blank">download</a> it first. You can then attempt to <a href="jetstream://">connect again</a></p>

If a user that already has a JetStream client browses to this link, the JetStream client application will pop up and behave as it did in the previous example. Users that do not have JetStream client installed will see a page with download instructions, and ability to connect to the server once they’ve installed the Jetsream Client.