# General configuration

**`--folder`**\
Specifies the root folder of the project.Please note that this option is not supported by the dockerized client yet. \
Default: the current folder \
Example: **`--folder=/projects/sample`**

**`--auth-file`**\
Specifies where to find the authorisation file, which can be downloaded from the "Tokens" view of the Meterian Dashboard \
Example: **`--auth-file=~/ci.json`**

**`--interactive`**\
When no authorisation file is present (or is invalid) and an authentication token is not present in the environment variables (see the section [authorisation in non-interactive mode](/the-client/using-client-ci-cd/autorization-in-non-interactive-mode.md) for more information)  this option allows using the system standard internet browser in order to perform the authentication\
Default: true \
Example: **`--interactive=false`**

**`--fail-gracefully`**\
In case of any system failure the client will report a non-zero exit code, thus failing or blocking the build if configured in a pipeline: this flag forces a 0 exit in case of a system failure\
Default: false \
Example: **`--fail-gracefully`**or **`--fail-gracefully=true`**

**`--exclude-folders`**\
Certain scanners are able to work recursively: in that situation is possible to exclude folders from the analysis using standard global regexes separated by commas\
Example: **`--exclude-folders=**/*.samples,**/*.labs`**

**`--ignore-exclusions`**\
Instruct the scanner to ignore all exclusions reported in the `.meterian` flle\
Default: false \
Example: **`--ignore-exclusions`** or **`--ignore-exclusions=true`**

**`--exclude-roots`**\
In a multi project setting, should you need to exclude certain sub-projects you can use this flag to specify them\
Example: **`--exclude-roots=app,lib`**

```
Root project 'basic-multiproject'
+--- Project ':android-sources'
+--- Project ':app'
\--- Project ':lib'
```

Given the above structure the example flag will cause project `app` and `lib` and all their sub-dependencies to be excluded  from the analysis 

**`--external-exclusions`**\
Specifies where to load the `.meterian` exclusions file from instead of loaded it directly from within your project folder (read more about exclusions [here](/the-meterian-webapp/advanced-functionalities/set-exclusion.md))\
Example: **`--external-exclusions=/path/to/a/folder`**


---

# 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.meterian.io/the-client/command-line-parameters/general-configuration.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.