> ## Documentation Index
> Fetch the complete documentation index at: https://gcore-doc-1046.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Edge Storage

Edge Storage allows you to store key-value pairs across our global edge network, providing super-fast, high-volume read capability.

## Creating Edge Storage

1\. In the [Gcore Customer Portal](https://portal.gcore.com/accounts/reports/dashboard), navigate to **FastEdge** and choose the relevant page: **Edge Storage**.

2\. In the top-right corner of the screen, click **Add Edge Storage**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/add-store.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=5fcf65c2da706049967e2bfb41a07f78" alt="FastEdge Edge Storage" width="1480" height="385" data-path="images/docs/fastedge/kv-stores/add-store.png" />
</Frame>

3\. Enter a name for your Edge Storage and provide a description if needed.

4\. Click **Create Edge Storage**. (This completes the Edge Storage creation step)

<Frame>
  <img
    src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/create-store.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=94d0d6f6328396ff8cd9ebb457a6b1af"
    alt="FastEdge Edge Storage
Creation"
    width="1268"
    height="470"
    data-path="images/docs/fastedge/kv-stores/create-store.png"
  />
</Frame>

5\. Proceed with inserting key-value pairs.

## Inserting KV pairs

#### 1. Add a key-value pair.

Click **Insert item** and select **KV Pair**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/insert-pair.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=4d73f9917b85d88df13b01e45ad6efea" alt="FastEdge Insert KV Pair" width="1257" height="582" data-path="images/docs/fastedge/kv-stores/insert-pair.png" />
</Frame>

In the side panel insert as many KV pairs as you need.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/first-pair.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=e0f23d61013f9142e66ac605b1d37a0b" alt="FastEdge Insert KV Pair" width="837" height="269" data-path="images/docs/fastedge/kv-stores/first-pair.png" />
</Frame>

Click **+ Add value** to get another entry row.

#### 2. Upload a value from a file.

Click the **Upload Icon** to add a value from file. This can be text and/or binary files (e.g. images / fonts etc..)

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/upload-pair.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=19cce035ad22efc9154d16f794dcebf0" alt="FastEdge Insert KV Pair" width="838" height="285" data-path="images/docs/fastedge/kv-stores/upload-pair.png" />
</Frame>

<Info>
  **Info**

  Uploading values from file has a 1 MB file size limit. Keys are limited to 256 bytes.

  **Note**:
  File uploads will transform the value in the UI Portal to a hash representation of its content.
</Info>

#### 3. Add a value with an expiration date.

Click the **Expiry Icon** to add a value with an expiration date/time.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/expire-pair.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=32835baaeb8f08c96744fda6e76980d6" alt="FastEdge Insert KV Pair" width="833" height="417" data-path="images/docs/fastedge/kv-stores/expire-pair.png" />
</Frame>

<Info>
  **Info**

  These values will stop being available in the runtime, after the expiration date. They may remain visible in the UI Portal for longer.
</Info>

## Editing KV pairs

1\. In the [Gcore Customer Portal](https://portal.gcore.com/accounts/reports/dashboard), navigate to **FastEdge** and choose the relevant page: **Edge Storage**.

2\. Find the Edge Storage you want to edit and click its name to open it.

3\. Find the key-value pair you want to edit, click the three-dot icon next to the key-value, and select edit.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/edit-store.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=03452af4aed9462d410902bcd6e3bc22" alt="FastEdge Edge Storage Edit" width="1247" height="704" data-path="images/docs/fastedge/kv-stores/edit-store.png" />
</Frame>

4\. You are now able to edit its value and/or provide an expiration date. If everything is configured correctly, click **Save**.

<Info>
  **Note**

  You can also insert more key-value pairs from this page. Duplicate keys overwrite the existing value.
</Info>

## Deleting KV pairs

1\. In the [Gcore Customer Portal](https://portal.gcore.com/accounts/reports/dashboard), navigate to **FastEdge** and choose the relevant page: **Edge Storage**.

2\. Find the Edge Storage you want to edit and click its name to open it.

3\. Find the key-value pair you want to delete, click the three-dot icon next to the key-value, and select delete.

4\. Confirm you want to delete the key-value pair.

## Bulk deleting KV pairs

1\. In the [Gcore Customer Portal](https://portal.gcore.com/accounts/reports/dashboard), navigate to **FastEdge** and choose the relevant page: **Edge Storage**.

2\. Find the Edge Storage you want to edit and click its name to open it.

3\. Find all the key-value pairs you want to delete, selecting their checkbox in the first column.

<Frame>
  <img
    src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/bulk-delete.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=b422299b7255b1dad00382fab62188d5"
    alt="FastEdge Edge Storage Bulk
Delete"
    width="1241"
    height="1133"
    data-path="images/docs/fastedge/kv-stores/bulk-delete.png"
  />
</Frame>

4\. Click **Group actions** and select **Delete all**.

5\. Confirm you want to delete all the key-value pairs.

## Accessing Edge Storage in applications

For more information regarding Edge Storage usage in applications see the [JavaScript SDK](https://g-core.github.io/FastEdge-sdk-js/reference/fastedge/kv/open/) and the [Rust SDK](https://docs.rs/fastedge/latest/fastedge/key_value/struct.Store.html)

<Info>
  **Info**

  In order to use Edge Storage in an application it must first be linked to the application. See [Managing Application - Edge Storage](/fastedge/manage-apps#edge-storage)
</Info>

## BYOD (Bring Your Own Data)

Edge Storage provides the ability to connect your own external key-value database.

To create a store with your own data:

1\. In the [Gcore Customer Portal](https://portal.gcore.com/accounts/reports/dashboard), navigate to **FastEdge** and choose the relevant page: **Edge Storage**.

2\. In the top-right corner of the screen, click **Add Edge Storage**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/add-store.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=5fcf65c2da706049967e2bfb41a07f78" alt="FastEdge Edge Storage" width="1480" height="385" data-path="images/docs/fastedge/kv-stores/add-store.png" />
</Frame>

3\. Enter a name for your Edge Storage and provide a description if needed.

4\. Check the BYOD checkbox and provide your database connection URL.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/NmzDUjLxfmvDFPXn/images/docs/fastedge/kv-stores/byod-store.png?fit=max&auto=format&n=NmzDUjLxfmvDFPXn&q=85&s=1362001b5705d374fd00ef2e3c6dafb3" alt="FastEdge Edge Storage BYOD" width="1253" height="537" data-path="images/docs/fastedge/kv-stores/byod-store.png" />
</Frame>

<Info>
  **Info**

  During the creation of the Edge Storage the server will attempt to connect to this database. Edge Storage creation will fail if a connection cannot be made.
</Info>

5\. If everything is configured correctly, click **Create Edge Storage**.

<Warning>
  **Warning**

  When creating Edge Storage, you cannot change between BYOD and hosted storage. Once you have created a store it can no longer be updated to change its type.
</Warning>
