# Troubleshooting

Common issues and advanced setup guides.

## Installation and Setup

- **[User Docker Installation](./docker.md)** — JupyterLab not accessible, permission errors, missing environment files, container build failures.

- **[Contributor Docker Installation](./devcontainers.md)** — DevContainer build failures, VS Code extension issues, performance problems.

- **[Contributor Local Installation](./local_dev.md)** — uv command not found, import errors, dependency conflicts, module not found errors.

- **[Jupyter Cannot Find PyRIT](./jupyter_setup.md)** — How to configure the correct Jupyter kernel when PyRIT isn't recognized in notebooks.

- **[Azure SQL Database Setup](./azure_sql_db.md)** — Setting up Azure SQL as your memory backend, including Entra ID authentication and user permissions.

## Model Deployment

- **[Deploy HuggingFace Models on Azure ML](./deploy_hf_model_aml.ipynb)** — Deploy HuggingFace models to Azure ML endpoints.

- **[Download & Register HuggingFace Models](./download_and_register_hf_model_aml.ipynb)** — Download and register HuggingFace models in Azure ML.

- **[HuggingFace Azure ML Endpoint Guide](./hf_aml_model_endpoint_guide.md)** — End-to-end guide for HuggingFace models on Azure ML.

- **[Score Azure ML Endpoints](./score_aml_endpoint.ipynb)** — Score and evaluate Azure ML model endpoints.

- **[Troubleshooting HuggingFace on Azure ML](./guide_hf_azureml.md)** — Common issues deploying HuggingFace models to Azure ML.