# Endpoint Storage

Endpoint Storage allows you to register an S3 Bucket in our system. When you have an Endpoint Storage set in our environment, you will be able to store some data from your deployment like the container's log.

{% hint style="info" %}
If you have already set up an Endpoint Storage and want to know how to save your container logs, please refer to the next section [How to Save Deployment Container Logs](https://docs.edgegap.com/docs/endpoint-storage/save-container-logs).
{% endhint %}

### How to Setup an Endpoint Storage

It is pretty simple to register your S3 Bucket if you follow these quick steps.

To see and set up a new Endpoint Storage, you need to go to the left menu and click on the `Log Storage` menu item.

<figure><img src="https://3027732442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-7d37a725cd5544c43cdc7b917a8875a335ba9cc0%2Fnavbar-menu.png?alt=media" alt=""><figcaption></figcaption></figure>

The first time you land on this page, you will not see any Endpoint storage in the list. Click on the create button in the upper right corner. You will be invited to complete this form. All fields are mandatory.

<figure><img src="https://3027732442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-2e80fecc21d4ff6ae5ff44dbc06872ab59b9e5b1%2Fcreate-form.png?alt=media" alt=""><figcaption></figcaption></figure>

**Name**

The name you want to give to your Endpoint Storage in our platform. It must be unique since you will be able to use it in some API calls.

**Access Key ID**

Pretty straightforward, the Access Key ID from your S3 Bucket.

**Secret Access Key**

The Secret Access Key from your S3 Bucket. This field will be encrypted and you will not be able to modify it once you saved your Endpoint Storage. Don't worry if you put the wrong Access Key, you will be able to completely delete the Endpoint Storage and create a new one.

**Endpoint URL**

Your S3 Bucket URL. Ensure that you include the full link (https\://, http\://, etc). You will be able to test it further in the process.

**Linode**

{% hint style="warning" %}
For Linode, the endpoint URL should NOT include the bucket name. For example: If your S3 bucket URL is <https://my-bucket.some-region.provider-name.com/>, the endpoint URL you should enter is <https://some-region.provider-name.com/>.
{% endhint %}

**AWS**

{% hint style="warning" %}
For AWS, the endpoint URL MUST include the bucket name. For example: If your S3 bucket name is my-test and your bucket URL is <https://my-test.s3.us-east.amazonaws.com>, the endpoint URL you should enter is <https://my-test.s3.us-east.amazonaws.com>.
{% endhint %}

**Bucket**

The name of your Bucket. Make sure to put the right name associated with the credential. Otherwise, we will not be able to access it correctly.

### Manage your Endpoint Storage

You can access all your Endpoint Storage available with the upper right menu. You can remove and test your Endpoint Storage. We are not deleting your S3 Bucket, we only remove the connection information from our system. If you want to update an Endpoint Storage, you must delete it and create a new one.

When you press "Test" button, it will upload a file named "connection\_test" under the "edgegap" directory in your S3 Bucket. You will have an alert box to notify you if it worked or not. If not, you might have something wrong in your Endpoint Storage configuration.

<figure><img src="https://3027732442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-218d863dddff861e4fee9238e08c8411c61389f0%2Fendpoint-storage-list.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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/docs/endpoint-storage.md?ask=<question>
```

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.
