> For the complete documentation index, see [llms.txt](https://docs.licensespring.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.licensespring.com/license-entitlements/portal/offline-portal/troubleshooting.md).

# Troubleshooting

{% hint style="info" %}
If the portal rejects a sync file, none of its usage is added to the license. The usage stays pending on the offline computer, so nothing is lost and nothing is counted twice when you try again.
{% endhint %}

| Message                                                            | Cause                                                                                 | What to do                                                                              |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| This file type is not supported                                    | The file is not a `.req` file                                                         | Upload the request file the application created                                         |
| The file is larger than 4 MB                                       | The request file is too large                                                         | Create a smaller request file in the application; for sync, sync fewer events at a time |
| The file references an account that does not exist on this server  | The file was created for a different account or environment                           | Check that the application is configured for this portal                                |
| This server does not accept sync files yet                         | The server does not support usage sync yet                                            | Contact your software vendor                                                            |
| A license error, for example "License not found (product: viewer)" | A license in the file cannot be found or used; for bundles, the product code is named | Check the license, then create a new request file                                       |
| The file is too large (after upload)                               | The server refused the file size                                                      | Create a sync file with fewer events                                                    |
| The server took too long to respond                                | The server or a gateway timed out                                                     | Click **Try again**, events already applied are not counted twice                       |
| Could not reach the server                                         | No connection to the server                                                           | Check the internet connection and click **Try again**                                   |

### Rejected Before Upload

The portal checks the file type and size before uploading. These errors mean the request never reached the server.

* **Wrong file type:** upload the `.req` file created by the application.

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FeOlOQqVxbImbBosJIRFO%2F03-upload-rejected-wrong-type.jpg?alt=media&amp;token=77845a44-d96b-4593-bfbc-7203443414f6" alt=""><figcaption></figcaption></figure>

* **File larger than 4 MB** : create a smaller request file.&#x20;

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2F0weOS3pFGxptSWpwAkQ0%2F04-upload-rejected-too-large.jpg?alt=media&amp;token=b8d9c590-d437-4e42-8306-be4257a2fbe2" alt=""><figcaption></figcaption></figure>

### Refused by the Server

* **Account not found**&#x20;

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FEzknwsobiFrN6OFoBC2I%2F13-error-account-not-found.jpg?alt=media&amp;token=1d1931c0-e98c-4ca2-bbf8-70d4e50a7303" alt=""><figcaption></figcaption></figure>

* **Sync is not supported**&#x20;

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FKgnEtScCeGR4atDTKaQo%2F14-error-sync-not-supported.jpg?alt=media&amp;token=3c15bef8-8fad-4b83-9b1f-c5159ea7a5c8" alt=""><figcaption></figcaption></figure>

* **License error**

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FjgVfWcbXZnF9eV3cPYUv%2F15-error-license-not-found.jpg?alt=media&amp;token=0e34492c-c286-4557-bb79-f9990f4a5203" alt=""><figcaption></figcaption></figure>

* **File too large after upload**

<figure><img src="https://1783554078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgLzurdfXUuKr9IziZWLz%2Fuploads%2FfvkshWg0QeOpqk7Hn38G%2F17-error-file-too-large-server.jpg?alt=media&amp;token=48ab86a4-dd3d-4b97-a567-ac66fc2a70b5" alt=""><figcaption></figcaption></figure>


---

# 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.licensespring.com/license-entitlements/portal/offline-portal/troubleshooting.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.
