# Troubleshooting

## Connection Issues

### 1. Verify provider URL and port

Make sure you're using the correct default URLs:
- **Ollama**: `http://localhost:11434`
- **LM Studio**: `http://localhost:1234`
- **llama.cpp**: `http://localhost:8080`

### 2. Check model and template compatibility

- Ensure the correct model is selected in settings
- Verify that the selected prompt template matches your model
- Some models may not support certain features (e.g., tool calling)

### 3. Linux compatibility

- Prebuilt binaries support Ubuntu 22.04+
- For other distributions, you may need to [build manually](../README.md#how-to-build)
- See [issue #48](https://github.com/Palm1r/QodeAssist/issues/48) for known Linux compatibility issues and solutions

## Reset Settings

If issues persist, you can reset settings to their default values:

1. Open Qt Creator → Settings → QodeAssist
2. Select the settings page you want to reset
3. Click "Reset Page to Defaults" button

**Note:**
- API keys are preserved during reset
- You will need to re-select your model after reset

## Chat History Migration

### Images not showing in old chats (version 0.5.x → 0.6.x)

If you have chat histories from QodeAssist version 0.5.x or earlier, images may not display correctly due to a storage structure change.

**Solution:** Rename the content folder for each affected chat:

```bash
# Navigate to your chat history folder
cd ~/path/to/chat_history

# For each chat file, rename its folder
mv chat_name_images chat_name_content
```

**Example:**
```bash
mv my_conversation_2024-11-28_images my_conversation_2024-11-28_content
```

**What changed:**
- Old format (v0.1): Stored files in `chat_name_images/`
- New format (v0.2): Stores all content in `chat_name_content/` (both images and text files)

## Common Issues

### Plugin doesn't appear after installation

1. Restart Qt Creator completely
2. Check that the plugin is enabled in About Plugins
3. Verify you downloaded the correct version for your Qt Creator

### No suggestions appearing

1. Check that code completion is enabled in QodeAssist settings
2. Verify your provider/model is running and accessible
3. Check Qt Creator's Application Output pane for error messages
4. Try manual suggestion hotkey (⌥⌘Q on macOS, Ctrl+Alt+Q on Windows/Linux)

### Chat not responding

1. Verify your API key is configured correctly (for cloud providers)
2. Check internet connection (for cloud providers)
3. Ensure the provider service is running (for local providers)
4. Look for error messages in the chat panel

## Getting Help

If you continue to experience issues:

1. Check existing [GitHub Issues](https://github.com/Palm1r/QodeAssist/issues)
2. Join our [Discord Community](https://discord.gg/BGMkUsXUgf) for support
3. Open a new issue with:
   - Qt Creator version
   - QodeAssist version
   - Operating system
   - Provider and model being used
   - Steps to reproduce the problem

