> ## Documentation Index
> Fetch the complete documentation index at: https://noqta.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Helpful guidance for resolving common issues and challenges you might encounter while using Saiku.

# Troubleshooting Saiku

Experiencing issues with Saiku? This troubleshooting guide addresses common problems, providing practical solutions and tips to help you resolve them quickly.

## Common Issues and Solutions

### 1. Installation Problems

* **Issue**: Difficulty installing Saiku or its dependencies.
* **Solution**: Ensure your system meets the prerequisites. Follow the installation guide step-by-step. If issues persist, consider using a virtual environment or container.

### 2. API Connectivity Issues

* **Issue**: Trouble connecting to external APIs like OpenAI.
* **Solution**: Check your internet connection. Verify that the API keys are correctly set in your environment variables. Ensure you're not exceeding API rate limits.

### 3. Unexpected Behavior or Errors

* **Issue**: Saiku is not behaving as expected or is throwing errors.
* **Solution**: Check for any common coding mistakes. Refer to the API documentation for expected behaviors and parameters. Look at the error logs for clues.

### 4. Action Module Issues

* **Issue**: Custom actions not working as intended.
* **Solution**: Verify the action's code and parameters. Test the action in isolation. Check if the action is compatible with the current version of Saiku.

## General Troubleshooting Tips

* **Check Logs**: Often, the logs will contain valuable information about what went wrong.
* **Update Saiku**: Ensure you're using the latest version of Saiku, as updates often fix known issues.
* **Community Support**: Reach out to the Saiku community. Other users may have faced and solved similar issues.

## Reporting Issues

Encountered an issue that you can't resolve? Report it on Saiku's GitHub issues page:

1. Provide a detailed description of the issue.
2. Include any error messages or screenshots.
3. Describe the steps to reproduce the problem.
4. Mention the version of Saiku you're using.

<Note>
  Keep an eye on the Saiku release notes and documentation for updates and solutions to known issues.
</Note>

***

Troubleshooting is an integral part of working with any software. We hope this guide helps you resolve any issues you encounter and enhances your Saiku experience.

<Footer />