> For the complete documentation index, see [llms.txt](https://docs.servoy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.servoy.com/reference/servoy-cloud/faq.md).

# FAQ

Servoy Cloud FAQ covering client idle-time shutdown, WAR export dependency exclusions, and svyCloudUtils module setup for Servoy Cloud applications.

<details>

<summary>How does the idle time shutdown feature work in Servoy Cloud, and how can I modify it?</summary>

Default behavior: Servoy Cloud will automatically shut down client sessions that remain idle for more than 30 minutes. This default applies to NG1 and TiNG clients only.

Recommended approach: instead of calling `application.addClientInfo()` directly, use the svyCloudUtils helpers (part of the svyCloud scope) to set tenant and idle-time metadata safely. For example:

```javascript
// Set max idle time in minutes using svyCloud (svyCloudUtils)
scopes.svyCloud.setMaxIdleTime(30);
```

Why use svyCloudUtils? The `svyCloud` scope ensures values are set consistently and avoids duplicate `application.addClientInfo()` calls that can overwrite or conflict with existing client metadata. See the svyCloud module docs for details: [svyCloud — svyCloudUtils module](/reference/servoyextensions/modules/svycloudutils/svycloud.md).

Notes:

* The `SERVOY_CLIENT_MAX_IDLE_TIME` value (when used directly) is expressed in minutes.
* Maximum allowed value is 180 minutes.
* Batch Processors and headless clients are not affected by this shutdown behavior.

The Cloud Control Center shows tenant and max idle time values in the Active User Sessions table; those values are populated from your application using svyCloudUtils. See the user sessions doc for how these fields are used: [Active user sessions](/reference/servoy-cloud/cloud-control-center/application-overview/applications/environments/metrics/users.md).

</details>

<details>

<summary>Why is a plugin JAR missing from the WAR file?</summary>

Cause: During WAR export a plugin JAR may be skipped if the export tool detects a duplicate or conflicting library in the lib folder. The export log will show a message similar to:

> **Dependency '/plugins//.jar' is not exported because '.jar' is already present in the lib folder.**

What to do:

* Inspect the `warExportCommandLine.log` in your pipeline artifacts to confirm which dependency caused the exclusion. For instructions on locating artifacts, see: [Package artifacts and how to access them](/reference/servoy-cloud/cloud-control-center/application-overview/applications/pipelines/jobs/packages/artifacts.md#how-to-access).
* Resolve the library conflict by ensuring a single version of the conflicting dependency is present, or update your build/pipeline configuration to include the required plugin JAR explicitly.

If the missing JAR belongs to a third-party extension, check that extension's documentation for compatibility notes. Also review your solution's extension/plugin docs and your build configuration to confirm whether any optional plugins or helpers are required.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.servoy.com/reference/servoy-cloud/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.