# Filemanager

Holesail file manager let's you share files and folders with anyone and across devices with a single command.

There are no restrictions on the number of files that can be shared, the bandwidth or the size of the file.

**Command:**

```
holesail --filemanager
```

Supported options:

| Option             | Purpose                                                                            | Required / Optional                      |
| ------------------ | ---------------------------------------------------------------------------------- | ---------------------------------------- |
| --filemanager      | Start file manager in current directory                                            | Required                                 |
| --filemanager PATH | Start file manager in the given directory                                          | Optional                                 |
| --username         | Set a custom username for authentication                                           | Optional. Default is admin               |
| --password         | Set a custom password                                                              | Optional. Default is admin               |
| --role             | Allow a user to create folder and files by setting role to **admin**               | Optional. Default is "user".             |
| --connector        | Set a custom connection string. Can not be less than 32 chars or equal to 64 chars | Optional. The default is auto-generated. |
| --force            | Bypass custom connection string length limit                                       | Optional. Default is false               |

<mark style="color:orange;">Examples:</mark>

1. Start a filemanager session in the current directory with default username and password:

```
holesail --filemanager
```

2. Start a filemanager session in a custom directory with custom username:

```
holesail --filemanager "/Users/supersu" --username "holesail"
```

3. Start a filemanager session in a custom directory with custom username and password and admin role:

```
holesail --filemanager "/Users/supersu" --username "holesail" --password "securepass@99#123" --role admin
```

You can combine multiple options according to your needs. You will get a connection string and QR code that you can use to connect with Holesail filemanager and access in the browser.


---

# 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.holesail.io/usage-guide/filemanager.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.