Skip to main content

​
Prerequisites

​
Environment Setup (Local Development Only)

Note: The .env file is only used for local development. In production, all configuration is done through Azure App Service → Configuration → Application Settings. Do not deploy a .env file to production.
Copy .env.example to .env in the project root and fill in your Cosmos DB values. See Setup Wizard → Prerequisites for the full variable reference.
These Cosmos DB variables are the only environment-level configuration required. All other application settings (AI endpoints, search config, auth, features, etc.) are stored in Cosmos DB and managed through the Admin UI or the Setup Wizard.

​
Installation

​
Development

Terminal 1 - Start the server:
Server runs at https://localhost:3000 Terminal 2 - Start the client:
Client runs at https://localhost:3001 Open the application: Navigate to https://localhost:3001
⚠️ Important: Always use https://localhost:3001 for development. Random ports will break MSAL authentication redirects.

​
Local HTTPS Certificates

Generate self-signed certificates for local HTTPS: