> For the complete documentation index, see [llms.txt](https://dbi-services.gitbook.io/yak-user-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dbi-services.gitbook.io/yak-user-doc/configuration/shapes.md).

# Provider shapes

The [provider shapes](/yak-user-doc/introduction/terms-and-definitions.md#provider-shapes) menu allows you to define the instance types that you want to be made available to the YaK for your future deployments.

Provider shapes are types of instance available on the provider side; they are defined by cloud service providers and offer a wide variety of combinations depending on customer requirements (performance, availability, cost, etc.) and server capacity (CPU, memory, storage and networking).

{% hint style="danger" %}
Operating costs and performance can vary considerably from one shape to another and from one cloud provider to another. Make sure you carefully select the shapes that best meet your needs and budget.
{% endhint %}

Examples of shapes per provider:

* AWS "t3.xlarge"
  * Low-cost burstable general purpose instance
  * 4vCPUS, 16GiB of memory, 5Gbps of Network burst bandwidth
* Azure "Standard\_B2ms"
  * General purpose instance
  * 2vCPUS, 8GiB of memory
* OCI "VM.Standard3.Flex"
  * 2 OCPUS, 8GiB of memory

See Cloud providers documentation for more details:

* AWS: <https://aws.amazon.com/ec2/instance-types/>
* Azure:
  * [List of VM size families by type](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/overview?tabs=breakdownseries%2Cgeneralsizelist%2Ccomputesizelist%2Cmemorysizelist%2Cstoragesizelist%2Cgpusizelist%2Cfpgasizelist%2Chpcsizelist)
  * <https://azure.microsoft.com/en-us/pricing/details/virtual-machines/series/#pricing>
* OCI: <https://docs.oracle.com/en-us/iaas/Content/Compute/References/computeshapes.htm>

## Add shapes

YaK already comes with a predefined list of the most common provider shapes, it's up to the user to add more shapes if needed

To do so:

* Navigate to **Configuration** -> **Provider shapes** in the menu
* Select the cloud provider you want to declare a new shape to, by selecting the appropriate tab
* Click "**Declare**"
* Fill-out the form with the requested information

{% hint style="info" %}
The shape definition must exist at your cloud provider and the shape name must match your provider's shape name.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dbi-services.gitbook.io/yak-user-doc/configuration/shapes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.