> For the complete documentation index, see [llms.txt](https://docs.rtkdata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rtkdata.com/enterprise-portal/fleets.md).

# Enterprise Fleets: Stream Contingents & Shared Logins

Share data streams across receivers in the RTKdata Enterprise Portal: stream contingents, fleet logins, moving streams, renewals and trials.

A fleet lets several receivers share one login and a number of connections. You buy streams as a **stream contingent**, then cut **fleet logins** from it, and shift streams between them whenever your needs change, without buying anything.

![The Fleets page](https://3957820804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJflLSSoC9TU9MkwT5lbC%2Fuploads%2Fgit-blob-e96c97b29548c791598a65294a3819734aabcad9%2Fenterprise-fleets.png?alt=media)

***

## How it fits together

* A **data stream** is one live connection at a time.
* A **stream contingent** is a pool of streams for one term, for example 12 streams for one year.
* A **fleet** is one login holding some of those streams. It runs until its contingent ends.

A fleet with 6 streams can have any number of receivers set up with its login, and 6 of them can be connected at once. A seventh disconnects another one.

The tiles at the top of the page show **Streams in use**, **Free streams** and **Active fleets**.

***

## Getting streams

**Buy streams** starts a new contingent.

![The Buy stream contingent dialog](https://3957820804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJflLSSoC9TU9MkwT5lbC%2Fuploads%2Fgit-blob-2c19fdb1b2c77531c40c26a2171400f9b2cf4fe1%2Fenterprise-buy-streams.png?alt=media)

Pick the number of **Data streams**, the **Pricing** (**Standard terms** or a fleet product agreed for your account) and, on standard terms, the **Term**. The dialog shows the price before you confirm, and it is billed with [this month's invoice](https://docs.rtkdata.com/enterprise-portal/billing.md). Sending a purchase again after an error never buys twice.

There are two other ways to get streams:

* **Through a quote.** [Purchase order accounts](https://docs.rtkdata.com/enterprise-portal/quotes.md) always order this way, and any account can ask for one under **Billing > Quotes**. The contingent appears here once it is delivered and links back to its quote.
* **From RTKdata.** RTKdata can add a contingent to your account, also free of charge. A free one ends on its date unless RTKdata extends it, so it cannot be renewed or topped up from your side.

***

## Your stream contingents

Each row is one contingent, with its name and colour, how many streams are in use and free, how close your peak use over the last 30 days came to its size, its pricing, its end date, and **Auto renew**. Open a row to see its logins, or click its fleet count to narrow the fleet table to it.

| Action           | What it does                                                                                                                                                                                 |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **New fleet**    | Creates a login from the free streams. Disabled while none are free                                                                                                                          |
| **Move streams** | Shifts streams from one fleet of this contingent to another                                                                                                                                  |
| **Free streams** | Gives streams from a fleet back to the contingent, ready for a new fleet                                                                                                                     |
| **Top up**       | Adds streams until the contingent ends. You enter the new total, the extra streams are billed pro rata with this month's invoice, and the dialog shows the charge and the new price per term |
| **Renew**        | Extends the contingent for another term at the price shown in its row. Every fleet on it runs to the new end                                                                                 |
| **Auto renew**   | Renews it by itself, ahead of its end                                                                                                                                                        |

***

## Creating fleets

**New fleet** asks for the number of **Data streams** and the login: type your own, or generate one. The login cannot be changed later, and works like a device's. See [Connection details](https://docs.rtkdata.com/enterprise-portal/devices.md#connection-details).

**Bulk create** makes many fleet logins at once, each with the same streams from one contingent, with the same prefix and download options as [bulk devices](https://docs.rtkdata.com/enterprise-portal/devices.md#creating-many-devices-at-once).

***

## Moving streams

![The Move streams dialog](https://3957820804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJflLSSoC9TU9MkwT5lbC%2Fuploads%2Fgit-blob-54aa980135822e740d0414c4b9af7d2212e740eb%2Fenterprise-move-streams.png?alt=media)

Streams only move between running fleets of the **same contingent**. Nothing is bought or billed, and the streams leave one fleet before the other gets them. A fleet's own **Move to** does the same from that fleet's row or page.

> **A fleet left with no streams is archived** and can no longer connect. Keep at least one on any fleet still in use. To use an archived fleet again, move streams to it first, then unarchive it on its page.

***

## The fleet page

![A fleet page](https://3957820804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJflLSSoC9TU9MkwT5lbC%2Fuploads%2Fgit-blob-2067a74ed0f16db2f436761562d31c1ed24a2000%2Fenterprise-fleet-detail.png?alt=media)

A fleet's page works like a [device's page](https://docs.rtkdata.com/enterprise-portal/devices.md#the-device-page), and adds what only a fleet needs:

* **Utilization** charts the share of its streams in use per day, as **Peak** and **Average**, for up to 30 days. A fleet that never reaches its streams can give some to another one. A peak at 100% means every stream was in use at some point that day.
* **Auto renew** and billing follow the contingent, so the fleet shows no price of its own.

| Action                      | What it does                                                                                          |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Suspend**                 | Pauses the login. It keeps holding its streams                                                        |
| **Archive** / **Unarchive** | Stops the login connecting, while term and billing run on                                             |
| **Delete**                  | Ends the login for good. Its streams go back to the contingent, and the username cannot be used again |

***

## Trials

RTKdata can grant your account free trial streams for a number of days. While a trial runs, a **Free trial streams** card shows on both the Devices and the Fleets page. You cannot start a trial yourself.

![The Free trial streams card](https://3957820804-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJflLSSoC9TU9MkwT5lbC%2Fuploads%2Fgit-blob-eecf90d43433e429de4db59ad01103d43f2c8807%2Fenterprise-trial-streams.png?alt=media)

* **New trial device** makes a login with one stream.
* **New trial fleet** makes a login with as many streams as you choose.
* **Every trial login ends with the trial.** Trial logins cost nothing.
* **Convert** keeps a login with the same credentials: a trial device becomes a paid device, a trial fleet gets a stream contingent of its own for its streams, billed with this month's invoice. Its trial streams become free again. On a purchase order account, conversion goes through a [quote](https://docs.rtkdata.com/enterprise-portal/quotes.md).

A trial marked **Starts on first connection** only starts counting when a login first connects, so a delivery delay does not use it up. The card shows the latest date it can still start.

To extend a trial, talk to your RTKdata contact.

***

## Next

* [Billing](https://docs.rtkdata.com/enterprise-portal/billing.md): how contingents are invoiced
* [Quotes & Purchase Orders](https://docs.rtkdata.com/enterprise-portal/quotes.md): ordering contingents through a quote
* [Usage & Live Map](https://docs.rtkdata.com/enterprise-portal/usage-and-live-map.md): seeing the fleets at work


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rtkdata.com/enterprise-portal/fleets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
