> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect/preparations-before-usage.md).

# Preparations Before Usage

## Hotfolder

In a **typical** installation of FYLR, this is already **done**. But in some instances this still has to be done by a **system administrator**. There is no harm in trying to use the Hotfolder without this step first and if FYLR refuses to give you the Hotfolder URL and points out this requirement instead, you know that this needs to be done.

You need **access** to the **configuration** of FYLR, typically a file called `fylr.yml` and you need to **restart** FYLR to make it re-read its **configuration**.

Here is the entry, that **needs** to be set in the **configuration**: (with some hierarchy above the entry for orientation)

```
fylr+:
  services+:
    api+:
      webDAVHotfolderPath: "/srv/hotfolder"
```

The **path** given needs to make sense inside the ***container***** filesystem** hierarchy.

Typically, the path is mapped to the outside of the container to the server file system, for space requirements or persistence. The [docker-compose.yml](https://github.com/programmfabrik/fylr-gitbook/blob/main/_assets/docker-compose.yml) given in our [installation instructions](/for-system-administrators/installation/linux-docker-compose.md) does this implicitly by mapping an outside directory to `/srv` inside the container.

## File System Connect

In contrast to `Hotfolder`, the method `File System Connect` **does not need preparation** by the **system administrator** and can be **set up** and **used directly**. It uses no real file system directory but relies only on **WebDAV**.

## Activate Services

**Additionally** the **upload** needs to be **enabled**: Go to **Base Configuration** > **Services** and enable "**Activate Hotfolder**" and / or "**Activate File System Connect**".

<div data-full-width="false"><figure><img src="/files/6mEZNmMoWK07MrccUFZC" alt=""><figcaption></figcaption></figure></div>

## Permissions

In order for **users** to be **able** to use the **Hotfolder** or **File System Connect**, a few **permissions** still need to be **assigned**.

The **users** (or user groups) **need** the **system rights** "**Access Search**" with "**Create Collections**" or "**Access Quick Access Only (No Search)**" as well as "**Frontend Features > Show File System Connect URL**" (for the File System Connect). For more details please refer to the [permissions](/for-administrators/permissions.md).

**Additionally** the users (or user groups) also **need** the permission to **create new records**, **upload files** and **read permissions** to at least one **pool**. This can be defined under "**Pools**". For more details please refer to [permissions](/for-administrators/permissions.md).


---

# 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:

```
GET https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect/preparations-before-usage.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.