# Troubleshooting

## Quick troubleshooting guide

Here is a quick guide for troubleshooting the startup of StackState on Kubernetes and Linux:

{% tabs %}
{% tab title="Kubernetes" %}

1. Check that the install completed successfully and the release is listed:

   ```
   helm list --namespace stackstate
   ```
2. Check that all pods in the StackState namespace are running:

   ```
   kubectl get pods
   ```
3. [Check the logs](/5.1/configure/logging.md) for errors.
4. Check the Knowledge base on the [StackState Support site](https://support.stackstate.com/).
   {% endtab %}

{% tab title="Linux" %}

1. Check that the systemd services StackGraph and StackState are running:

   ```
   sudo systemctl status stackgraph
   sudo systemctl status stackstate
   ```
2. Check connection to StackState's user interface, default listening on TCP port 7070.
3. Check log files for errors, located at `/opt/stackstate/var/log/`
4. Check the Knowledge base on the [StackState Support site](https://support.stackstate.com/).
   {% endtab %}
   {% endtabs %}

## Known issues

Check the [StackState support Knowledge base](https://support.stackstate.com/hc/en-us/sections/360004684540-Known-issues) to find troubleshooting steps for all known issues.


---

# 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://archivedocs.stackstate.com/5.1/setup/install-stackstate/troubleshooting.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.