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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.licensespring.com/floating-server/floating-server-v1/deployment-methods/kubernetes-helm/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
