Azure Blob Storage Setup Guide¶

This guide covers creating an Azure Storage Account and container, configuring it in Flexible GraphRAG, and optionally enabling Change Feed for near real-time sync.

1. Create a Storage Account¶

1. Go to portal.azure.com and sign in
2. Search for "Storage accounts" and click + Create
3. Fill in the basics:
4. Subscription and Resource group — select or create one
5. Storage account name — e.g. mystorageaccount (lowercase, 3–24 chars)
6. Region — choose one close to you
7. Performance — Standard
8. Redundancy — LRS is fine for most use cases
9. Click Review + Create, then Create

Note: Change Feed requires a General-purpose v2 account (the default). Blob Storage accounts also work.

2. Create a Container¶

1. Open your new Storage Account
2. In the left menu under Data storage, click Containers
3. Click + Container
4. Name — e.g. graphrag-docs
5. Public access level — Private (no anonymous access)
6. Click Create

Upload your documents to this container using the Azure Portal's Upload button or Azure Storage Explorer.

3. Get Your Credentials¶

You need the Account Name, Account URL, and Account Key for Flexible GraphRAG.

1. In your Storage Account, go to Security + networking → Access keys
2. Click Show next to key1
3. Note down:
4. Storage account name (top of the page)
5. Key (the long base64 string under key1)
6. Your Account URL is: https://<storage-account-name>.blob.core.windows.net

4. Configure in Flexible GraphRAG¶

In the Add Data Source form, select Azure Blob Storage and fill in:

In the Processing tab: - Check Auto Sync to enable incremental monitoring — Flexible GraphRAG will automatically detect files added, modified, or deleted in the container

5. Enable Change Feed (Optional — for faster sync)¶

Without Change Feed, Flexible GraphRAG scans the container every 5 minutes. With Change Feed enabled, changes are detected within seconds.

1. Open your Storage Account in the Azure Portal
2. In the left menu under Data management, click Data protection
3. Scroll to the Tracking section
4. Check Enable blob change feed
5. Set Retention period — 7 days is sufficient
6. Click Save

That's it — no changes needed in Flexible GraphRAG. The app detects Change Feed automatically on startup and logs Azure Blob detector started in CHANGE FEED MODE. If Change Feed is not enabled it logs Falling back to periodic refresh mode and continues using 5-minute scans.

How It Works¶