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

# Troubleshooting connections

> Resolve common connection issues for IdeaBoxAI knowledge base connectors and data imports.

This guide covers the most common connection issues in IdeaBoxAI and how to resolve them. If a problem persists after following these steps, contact the platform team.

## Structured knowledge base issues

The following table covers issues related to database connections in structured data knowledge bases.

| Problem                        | Resolution                                                                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Connection refused**         | Check that the host and port are correct and reachable. Verify firewall rules allow inbound connections from the IdeaBoxAI platform.                                                       |
| **Authentication failed**      | Confirm the username and password are correct. Use a read-only service account. For SSL issues, confirm whether the database requires SSL and toggle the **SSL Mode** setting accordingly. |
| **Schema import hangs**        | The database may have too many tables. Filter to relevant schemas before connecting if possible. Contact the platform team if the issue persists.                                          |
| **Cube query returns no data** | Check that the selected measures and dimensions are valid for the cube. Inspect the **Generated SQL** tab for errors and ensure the underlying tables are not empty.                       |

## Unstructured knowledge base issues

The following table covers issues related to document uploads and external source imports.

| Problem                       | Resolution                                                                                                                            |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **File stuck in Processing**  | Remove the file and re-upload. Ensure the PDF is machine-readable (not a scanned image). For large files, split into smaller batches. |
| **Confluence import fails**   | Regenerate the Atlassian API token. Confirm the user has read access to the selected spaces. Try importing a smaller space first.     |
| **Google Drive import fails** | Re-authenticate with Google (OAuth token may have expired). Check that the user has access to the selected folders.                   |

## Next steps

<CardGroup cols={2}>
  <Card title="Knowledge base connections" icon="database" href="/connectors/knowledge-base-connections">
    Review setup steps for database and document connections.
  </Card>

  <Card title="Connector directory" icon="grid-2" href="/connectors/connector-directory">
    Browse all available connectors by category.
  </Card>
</CardGroup>