> For the complete documentation index, see [llms.txt](https://archivedocs.stackstate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://archivedocs.stackstate.com/5.1/setup/install-stackstate/troubleshooting.md).

# 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.
