> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/tools/mariadb-ai-rag/reference.md).

# Reference

MariaDB AI RAG reference section provides complete environment variable documentation, supported file formats, and integration patterns for connecting the REST API to external systems.

This section provides detailed reference information for configuring and integrating the MariaDB AI RAG system.

## Documentation in This Section

### [Configuration Guide](/docs/tools/mariadb-ai-rag/reference/configuration-guide-config.env.md)

Complete reference for all environment variables:

* Database configuration
* API keys and secrets
* Embedding provider settings
* LLM provider configuration
* Service ports and hosts
* Authentication settings

### [Supported File Formats](/docs/tools/mariadb-ai-rag/reference/supported-formats.md)

List of supported document formats for ingestion:

* PDF documents
* Microsoft Office files (DOCX, XLSX, PPTX)
* Text files (TXT, MD, CSV)
* Code files (Python, JavaScript, Java, etc.)
* And more

### [Integration](/docs/tools/mariadb-ai-rag/reference/integration.md)

Guide for integrating the RAG API with external systems:

* REST API integration examples
* Authentication workflows
* Client library usage
* Document management system integration
* Business intelligence tool integration
* Custom application integration

## Configuration Best Practices

When configuring your MariaDB AI RAG deployment:

1. **Security**: Always use strong secrets for JWT tokens and API keys
2. **Performance**: Configure appropriate batch sizes for your workload
3. **Scalability**: Set connection pool sizes based on expected load
4. **Monitoring**: Enable logging and health check endpoints
5. **Integration**: Use environment variables for flexible deployment

## Additional Resources

* [API Reference](/docs/tools/mariadb-ai-rag/api-reference.md) - Complete API endpoint documentation
* [Configuration Guide](/docs/tools/mariadb-ai-rag/getting-started/configuration.md) - Detailed configuration instructions

<sub>*This page is: Copyright © 2026 MariaDB. All rights reserved.*</sub>

{% @marketo/form formId="4316" %}