# The Root Directory

The root directory in Couchdrop is a key security mechanism.&#x20;

When users are added, you must choose a root directory. The root directory in Couchdrop behaves a bit like the home directory in a unix environment with a couple of caveats.

* Users cannot navigate outside the root directory
* Users can only see paths relative to the root directory
* The true location of the root directory is hidden
* Users can share the same root directory&#x20;

Root directories can have permissions to give added controls.

* Read only users: *Can only download and view content in directory*
* Write only users: *Users can only upload files to the directory, they cannot view existing files or folders*

Example Root Directory:

<figure><img src="/files/Xmm3NLKSFHOTzJt9vD19" 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.couchdrop.io/administration/users-and-groups/the-root-directory.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.
