> 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/floating-server/floating-server-v1/deployment-methods/kubernetes-helm/troubleshooting.md).

# Troubleshooting

If your questions are not answered here or in the [**FAQ**](/floating-server/faq.md), please [**submit a support ticket**](https://licensespring.zendesk.com/hc/en-us/requests/new) and our support team will respond as soon as possible!

<details>

<summary>Issue: Helm Chart Deployment Fails</summary>

{% hint style="info" %}
Ensure that all required configuration values are properly set in your Helm values file. This includes specifying the database type (Redis) and ensuring your Kubernetes cluster has sufficient resources for the deployment.
{% endhint %}

You can inspect the logs of the failing pods with:

```bash
kubectl logs <pod-name>
```

</details>

<details>

<summary>Issue: Redis Not Connecting to Floating Server</summary>

{% hint style="info" %}
Verify that Redis and the Floating Server are deployed in the same namespace and that Redis is reachable from the Floating Server. Check the service definitions and ensure that the Redis service is properly exposing its ports.
{% endhint %}

Example service port configuration:

```yaml
ports:
  - port: 6379
```

</details>

<details>

<summary>Issue: Data Not Persisting in Redis</summary>

{% hint style="info" %}
Ensure that a persistent volume claim (PVC) is set up for Redis to store data across restarts. Check your Helm values file to confirm the PVC is defined.
{% endhint %}

Example PVC settings in Helm values:

```yaml
persistence:
  enabled: true
  storageClass: <your-storage-class>
  accessModes:
    - ReadWriteOnce
  size: 1Gi
```

</details>

<details>

<summary>Issue: Floating Server Not Accessible</summary>

{% hint style="info" %}
Make sure that the Kubernetes service for the Floating Server is correctly exposing the port.
{% endhint %}

Use this command to check the service configuration:

```bash
kubectl get svc <floating-server-service>
```

Ensure that the correct port is exposed and accessible from outside the cluster.

</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.licensespring.com/floating-server/floating-server-v1/deployment-methods/kubernetes-helm/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.
