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

# Common Issues

> Solutions to frequently encountered problems

Quick solutions to common problems you might encounter.

## Connection Issues

<AccordionGroup>
  <Accordion title="Cannot connect VCS">
    **Symptoms**: Connection fails or times out

    **Solutions**:

    * Verify credentials are correct
    * Check network connectivity
    * For self-hosted VCS, verify URL is accessible
    * Check firewall allows outbound HTTPS
    * Try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Repositories not appearing">
    **Symptoms**: Connected VCS but repositories don't show

    **Solutions**:

    * Verify you have admin access to repositories
    * For organizations, ensure OAuth app is approved
    * Check repositories aren't archived
    * Re-authorize the VCS connection
    * Refresh repository list
  </Accordion>
</AccordionGroup>

## Scanning Issues

<AccordionGroup>
  <Accordion title="Scan stuck in PENDING">
    **Symptoms**: Scan doesn't start, stays pending

    **Solutions**:

    * Wait 5-10 minutes (scans may queue during busy times)
    * Check plan scan limits aren't exceeded
    * Verify workers are online (contact support)
    * Cancel and restart scan
  </Accordion>

  <Accordion title="Scan failed">
    **Symptoms**: Scan shows FAILED status

    **Solutions**:

    * Check scan error message for details
    * Verify repository is accessible
    * Check repository isn't too large (>10GB)
    * Ensure no corrupted files
    * Try scanning again
  </Accordion>

  <Accordion title="Too many false positives">
    **Symptoms**: Many violations are false positives

    **Solutions**:

    * Enable AI false positive elimination
    * Increase AI filtering aggressiveness
    * Exclude test directories from scans
    * Manually suppress false positives with justification
    * Contact support for custom rules
  </Accordion>
</AccordionGroup>

## Violation Issues

<AccordionGroup>
  <Accordion title="Violation not marked as fixed">
    **Symptoms**: Fixed code but violation still shows as OPEN

    **Solutions**:

    * Trigger new scan to detect fix
    * Verify fix actually resolves the issue
    * Check violation hash hasn't changed (file moved, line numbers shifted significantly)
    * Manually mark as fixed if needed
  </Accordion>

  <Accordion title="Can't change violation status">
    **Symptoms**: Status change button doesn't work

    **Solutions**:

    * Verify you have ADMIN role or appropriate custom role permissions
    * Check you're not in read-only demo mode
    * Provide justification (required for status changes)
    * Try refreshing page
  </Accordion>
</AccordionGroup>

## PR Integration Issues

<AccordionGroup>
  <Accordion title="PR scans not triggering">
    **Symptoms**: PRs don't get scanned automatically

    **Solutions**:

    * Verify auto-scan on PR is enabled
    * Check webhook delivery in VCS
    * Ensure webhook is active
    * Verify repository is connected
    * Check plan limits
  </Accordion>

  <Accordion title="GitHub Check not appearing">
    **Symptoms**: CodeThreat check doesn't show on PR

    **Solutions**:

    * Verify GitHub App is installed
    * Check PR scanning is enabled
    * Ensure webhook is working
    * Wait a few minutes for check to appear
    * Trigger scan manually
  </Accordion>
</AccordionGroup>

## Access Issues

<AccordionGroup>
  <Accordion title="Can't access repository">
    **Symptoms**: Repository doesn't appear in list

    **Solutions**:

    * Verify repository access control settings
    * Check you have required role/permission
    * Ask admin to grant access
    * Verify repository is connected
  </Accordion>

  <Accordion title="Features are disabled">
    **Symptoms**: Can't use expected features

    **Solutions**:

    * Check your plan limits
    * Verify feature is available in your plan
    * Check organization/repository settings
    * Verify you have required role
  </Accordion>
</AccordionGroup>

## Performance Issues

<AccordionGroup>
  <Accordion title="Slow scan performance">
    **Symptoms**: Scans taking too long

    **Solutions**:

    * Exclude unnecessary directories (node\_modules, vendor)
    * Reduce Git history depth scanned
    * Split large repositories
    * Check repository size (\<5GB recommended)
    * Contact support for optimization
  </Accordion>

  <Accordion title="Dashboard loading slowly">
    **Symptoms**: UI is slow or unresponsive

    **Solutions**:

    * Clear browser cache
    * Try different browser
    * Check internet connection
    * Reduce selected time range for reports
    * Contact support if persistent
  </Accordion>
</AccordionGroup>

## Still Having Issues?

<CardGroup cols={2}>
  <Card title="Scan Problems" icon="magnifying-glass" href="/troubleshooting/scan-problems">
    Detailed scan troubleshooting
  </Card>

  <Card title="Integration Issues" icon="plug" href="/troubleshooting/integration-issues">
    VCS and integration problems
  </Card>

  <Card title="Contact Support" icon="life-ring" href="mailto:support@codethreat.com">
    Email [support@codethreat.com](mailto:support@codethreat.com)
  </Card>

  <Card title="Community" icon="discord" href="https://discord.gg/codethreat">
    Join our Discord
  </Card>
</CardGroup>