# Location Manager

<figure><img src="https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-e82b0ca4a30194fba8996542c5df2bd51eaf9486%2Fimage.png?alt=media" alt=""><figcaption><p>How to reach the location manager in the black menu and an example view of the location manager</p></figcaption></figure>

## Working with the Location Manager

To **create** a new location, click on the **plus** button in the lower **left** and enter the details (see below). By **clicking** on a **location**, you can see and edit the details. To **remove** a location, **click** on the desired **location** and on the **minus** button in the lower **left**.

## Default storage locations

Click on the **settings** ![](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-91df79cde7e421f70911c7fb94b75940043998f9%2Fimage.png?alt=media) icon in the lower **right** to configure the **default** storage locations.

This configures in which locations *new* files will be stored. Locations marked as read-only cannot be used here.

*Already existing* files are still used in all locations, not only the default locations.

<figure><img src="https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-c07304389d4dd7e9fd8d99b106de03fac8562ecb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Details

| OPTION            | DESCRIPTION                                                                                                                                                                                                                                                               |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                | an unique number for each location                                                                                                                                                                                                                                        |
| Status            | fylr tests the connection to the storage location and displays the result here                                                                                                                                                                                            |
| Prefix            | an optional path preceding each file, for example to separate from other data                                                                                                                                                                                             |
| Allow Purge       | when purging this fylr instance, shall the files also be deleted?                                                                                                                                                                                                         |
| Allow Redirect    | whether to hide S3 URLs behind fylr's own URL                                                                                                                                                                                                                             |
| Read Only         | Prevents changes made by fylr. Can not be set for locations that are currently configured as Default Storage Locations.                                                                                                                                                   |
| Type              | Filesystem, S3 Bucket or Azure blob storage                                                                                                                                                                                                                               |
| Directory         | A path - only for type `Filesystem`. Either an absolute path on the system visible to fylr (might be in a container); or a path relative to the fylr executable (e.g. in a container, it is relative to `/fylr/bin/`, which is not recommended, so use an absolute path). |
| Access Key        | Credentials for type S3                                                                                                                                                                                                                                                   |
| Secret Key        | Credentials for type S3                                                                                                                                                                                                                                                   |
| Bucket Name       | Needed for type S3                                                                                                                                                                                                                                                        |
| Endpoint          | URL for type S3                                                                                                                                                                                                                                                           |
| Region            | For type S3, defined by your S3 provider                                                                                                                                                                                                                                  |
| SSL               | Whether to use https with S3                                                                                                                                                                                                                                              |
| Account Name      | Credentials for Azure Blob storage                                                                                                                                                                                                                                        |
| Account Key       | Credentials for Azure Blob storage                                                                                                                                                                                                                                        |
| Endpoint Suffix   | For Azure Blob storage                                                                                                                                                                                                                                                    |
| Connection String | For Azure Blob storage, this is an *alternative* to giving Account Name, Account Key and Endpoint Suffix separately. Do **not** give *both*.                                                                                                                              |
| Container         | For Azure Blob storage                                                                                                                                                                                                                                                    |


---

# 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.fylr.io/for-administrators/location-manager.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.
