# Private Fleets
Reserve standby capacity on monthly basis and choose your preference between Virtual Machines (Performance) or Bare Metal (Overdrive) specifications.
**Private Fleets are an optional addition to Edgegap Cloud (default),** a popular hosting option:
* enabling [Persistence](/learn/orchestration/persistence.md) with 24/7 always online servers, and
* favorable [Deployments](/learn/orchestration/deployments.md#match-bound) pricing with predictable traffic.
🌟 [**Upgrade to Pay as You Go tier**](https://app.edgegap.com/user-settings?tab=memberships) **to unlock private fleets hosting with standby capacity!**
{% hint style="success" %}
Alternatively, see [Deployments](/learn/orchestration/deployments.md#match-bound) cloud orchestration to utilize fractional vCPU pricing.
{% endhint %}
## ✔️ Introduction
Private Fleets let you pick specific host locations and reserve dedicated standby compute capacity within our globally available provider-agnostic infrastructure, suitable for:
* **live games with predictable daily traffic** **patterns** and stable player communities,
* **persistent 24/7 servers** featuring open worlds with user-generated content placed by players,
* **MMO games** prioritizing social experiences with high amount of concurrent users per server.
## ↕️ Allocations
Orchestrating your fleet capacity efficiently can make or break your cost savings. Finding the optimal ratio between Fleet and Cloud Overflow hybrid requires multiple iterations.
### 1. Schedule Hosts
Planning your Private Fleet capacity is an important recurring monthly DevOps activity.
Scheduling additional hosts for your fleet ahead of time is recommended if you expect any special events impacting your capacity such as:
* global or regional launch, or a major update,
* blanket discount, or free test weekend,
* streamer event, tournament, or other public event.
{% hint style="warning" %}
The minimum commitment period for fleet hosts is one (1) month. Once your host is started, **the earliest date for scheduling host deletion and reducing cost is end of month**.
{% endhint %}
{% hint style="success" %}
Use early signals (e.g. wishlists) to project regional demand and mitigate overprovisioning. Struggling to project traffic with confidence? Start low and [#overflow-to-cloud](#overflow-to-cloud "mention").
{% endhint %}
#### Locations
Drop a pin on the map and preview your primary/fallback locations for new hosts.
Select a fallback strategy to control suitable locations for each centroid:
* **Proximity (default)** - 700 km centroid radius, for precise control.
* **Redundancy** - 1,400 km centroid radius, allowing more fallback locations.
{% hint style="info" %}
Location availability depends on chosen hardware specification. Overdrive availability is limited.
{% endhint %}
📢 API provisioning under development, [let us know](https://discord.gg/NgCnkHbsGp) about your Continuous Integration needs!
### 2. Discover Hosts
{% hint style="warning" %}
**Starting your Deployments manually, pasting URL and ports will not cut it for a live game.**
{% endhint %}
Automate popular game flows for managing sessions and scaling on demand with either:
{% columns %}
{% column width="33.33333333333333%" %}
[Matchmaking](/learn/matchmaking.md):
* Shorter Rounds
* On-Demand Matches
* Skill Rating and/or Custom Rules
{% endcolumn %}
{% column width="33.33333333333333%" %}
[Server Browser](/learn/server-browser.md):
* Persistent or Rounds
* Social Regional Hubs
* Auto-Assign and/or\
Custom Search
{% endcolumn %}
{% column width="33.33333333333333%" %}
Custom Backend:
* Migrate Live Games
* [Deploy with v2 API](/docs/api/dedicated-servers.md)
* [Observe Webhooks](/learn/orchestration/deployments.md#webhooks)
{% endcolumn %}
{% endcolumns %}
Your session orchestration must be aware of available hosts to utilize fleet capacity:
**On-Demand** deployments:
* Matchmaking maintains a cached list of hosts, refreshed every minute.
* Matchmaking assigns one of the available beacons to each active host.
* Players receive host assignment depending on the best matched beacon.
**Pre-Warmed** deployments:
* Your DevOps administrator reviews available hosts and [configures policies](/learn/server-browser.md#automated-scaling).
* Players get an auto-assigned seat, or search and choose a server.
{% hint style="info" %}
Custom integrations fetch hosts and deploy servers using [Dedicated Servers](/docs/api/dedicated-servers.md#private-fleets) API.
{% endhint %}
### 3. Deploy Servers
Start deployments on Private Fleet using the same parameters as Cloud deployments, with the **added option to specify a prioritzed list of host IDs you wish to deploy to**.
Deployments will be started on the first private host with sufficient capacity in your request. If no listed host has capacity available at the time, deployments will [#overflow-to-cloud](#overflow-to-cloud "mention").
#### Overflow to Cloud
{% hint style="warning" %}
**Unexpectedly high player traffic may exceed your current fleet capacity**, causing some deployments to utilize Cloud Overflow instead of your Private Fleet. Cloud limitations apply.
{% endhint %}
Prepare for this possibility and review differences:
|
| RAM Specifications | 32 GB | 64 GB |
| Free Egress Included | 5 TB per Host | 5 TB per Host |
|
Price, pre-paid monthly
(commitment based)
| **$250.00 per Host** | **$290.00 per Host** |
{% hint style="success" %}
Estimate cloud/fleet ratios with [pricing calculator](https://edgegap.com/resources/pricing/calculator#important-notes). Get final fleet price [using dashboard reservation](https://app.edgegap.com/private-fleet-management/private-fleets/list).
{% endhint %}
**Your first month's reservation price and free egress quota are pro-rated.** This means you are charged only for the portion of time until the end of current month.
**Reservations automatically renew on the
first day of every month at 00:00 UTC until deleted.** Your card will be automatically charged the monthly amount for renewed hosts at this time.
{% hint style="warning" %}
A fleet with [active hosts](#lifecycle) may not swap specifications. Create a new fleet or delete active hosts first.
{% endhint %}
{% hint style="info" %}
Small amount of resources on each host is reserved for Operating System, Monitoring, and Orchestration.
{% endhint %}
#### Modifying Schedule and Deleting Hosts
You may modify or delete a schedule at any time prior to the scheduled time, at no charge. You may designate any number of reserved (active) private hosts for deletion at the end of the current billing period, prior to the renewal date. Deleted hosts will not be charged for subsequent renewals. Any deployments running on private hosts scheduled for deletion will be gracefully shut down at the time of deletion without additional warnings.
#### Delayed Start or Insufficient Provider Capacity
In the event of delayed private host start or insufficient provider capacity, your payment amount and invoice for the scheduled or renewal periods will be adjusted accordingly.
## 🔄 Host Lifecycle
Private Fleet hosts follow a simple lifecycle sequence.
#### 1. Pending
New hosts have been requested, we're starting them in order of distance from your pin.
In our [List Hosts API](/docs/api/dedicated-servers.md#get-private-fleets-fleet-name-hosts), hosts in this stage are indicated with status `PENDING`.
#### 2. Active
Host is active and responsive, ready to [/pages/0UXQAhtFuL0FkdoUmYTh#id-1.-start-a-deployment](https://docs.edgegap.com/learn/orchestration/pages/0UXQAhtFuL0FkdoUmYTh#id-1.-start-a-deployment "mention").
In our [List Hosts API](/docs/api/dedicated-servers.md#get-private-fleets-fleet-name-hosts), hosts in this stage are indicated with status `ACTIVE`.
#### 3. Scheduled for Deletion
While stile active, this host will be deleted at the end of the current billing period (month). This action can be reverted (cancelled) at any time until deletion takes place.
In our [List Hosts API](/docs/api/dedicated-servers.md#get-private-fleets-fleet-name-hosts), hosts in this stage are indicated with non-null `delete_schedule` .
#### 4. Deleting
When a host reaches the scheduled deletion time, new deployments will no longer be assigned to it.
In our [List Hosts API](/docs/api/dedicated-servers.md#get-private-fleets-fleet-name-hosts), hosts in this stage are indicated with status `PERMANENTLY_REMOVING`.
{% hint style="warning" %}
Deployments running on private hosts will be [gracefully stopped](https://docs.edgegap.com/learn/orchestration/pages/0UXQAhtFuL0FkdoUmYTh#id-5.-deployment-stopped) once the host is deleted.
{% endhint %}
{% hint style="success" %}
**Prevent frustration due to rollbacks and gameplay disruption** by notifying players and rerouting new deployments to other private fleet hosts, once a private host scheduled for deletion is nearing shutdown.
{% endhint %}
#### 5. Error and Other
In case of issues with the provider or the host, our platform marks the host as `DEFECTIVE` and attempts to start a new host as replacement at no additional charge. The new host will always be started in the same location and bear the same name. For a short period of time, you may see both the defective and the new replacement host with the same name.
When transitioning between states, a [host may shortly](#user-content-fn-3)[^3] report `SERVICE_UNAVAILABLE` .
We reserve a few other states to indicate special circumstances: `ERROR` , `DOWN`, `MAINTENANCE` .
{% hint style="info" %}
If you need help, [please reach out to us over Discord](https://discord.gg/MmJf8fWjnt). For live games support see our [ticketing system](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
[^1]: base frequency
[^2]: turbo - short CPU bursts
[^3]: for a few milliseconds
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.edgegap.com/learn/orchestration/private-fleets.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.