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

# Help & Troubleshooting

> Get help with common issues and find answers

Find solutions to common problems, understand error codes, and get help from the community.

## Quick Diagnosis

Run these commands to identify issues:

```bash theme={null}
# Check file health
memvid verify knowledge.mv2 --deep

# View file stats
memvid stats knowledge.mv2 --json

# Check for locks
lsof knowledge.mv2
```

## Common Issues

<AccordionGroup>
  <Accordion title="File is locked">
    Another process has the file open. Find it with `lsof knowledge.mv2` or open in read-only mode:

    ```python theme={null}
    mem = use('basic', 'knowledge.mv2', read_only=True)
    ```
  </Accordion>

  <Accordion title="Search returns no results">
    Check the search mode and verify content exists:

    ```bash theme={null}
    memvid stats knowledge.mv2  # Check frame count
    memvid find knowledge.mv2 --query "test" --mode lex  # Try lexical
    ```
  </Accordion>

  <Accordion title="Capacity exceeded">
    Upgrade your plan or delete old content:

    ```bash theme={null}
    memvid tickets sync knowledge.mv2 --memory-id YOUR_ID
    ```
  </Accordion>

  <Accordion title="Import errors">
    Reinstall the SDK:

    ```bash theme={null}
    pip install --upgrade memvid-sdk  # Python
    npm install @memvid/sdk           # Node.js
    ```
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Error Reference" icon="book" href="/errors/reference">
    Complete list of error codes with solutions
  </Card>

  <Card title="Troubleshooting Guide" icon="wrench" href="/errors/troubleshooting">
    Step-by-step solutions for common issues
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq/general">
    Frequently asked questions
  </Card>

  <Card title="Security FAQ" icon="shield" href="/faq/security-and-compliance">
    Security, privacy, and compliance questions
  </Card>
</CardGroup>

## Get Help

<CardGroup cols={3}>
  <Card title="Discord" icon="discord" href="https://discord.gg/2mynS7fcK7">
    Join our community for real-time help
  </Card>

  <Card title="GitHub Issues" icon="github" href="https://github.com/memvid/memvid/issues">
    Report bugs or request features
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:support@memvid.com">
    Contact our support team
  </Card>
</CardGroup>
