Events
Jan 14, 8 PM - Feb 25, 7 PM
Azure Cosmos DB Conf 2025 Call for Proposals
Submit your session proposal by Feb. 25th and be part of Azure Cosmos DB Conf 2025.This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
The Azure Cosmos DB emulator provides a local environment that emulates the Azure Cosmos DB service designed for development purposes. Using the emulator, you can develop and test your application locally, without creating an Azure subscription or incurring any service costs. When you're satisfied with how your application is working with the emulator, you can transition to using an Azure Cosmos DB account with minimal friction.
Important
We do not recommend the use of the emulator for production workloads.
Tip
Visit our new Samples Gallery for the latest samples for building new apps
The emulator provides an environment on your developer workspace that isn't capable of emulating every aspect of the Azure Cosmos DB service. Here are a few key differences in functionality between the emulator and the equivalent cloud service.
Important
The Linux emulator currently doesn't support developer machines running on Apple silicon series or Microsoft ARM chips. A temporary workaround is to install a Windows virtual machine and run the emulator on that platform.
Alternatively, you can used the new Linux-based Azure Cosmos DB emulator (preview).
JOIN
statements per query.The emulator's features may lag behind the pace of new features for the cloud service. There could potentially be new features and changes in the cloud service that have a small delay before they're available in the emulator.
Every request made against the emulator must be authenticated using a key over TLS/SSL. The emulator ships with a single account configured to use a well-known authentication key. By default, these credentials are the only credentials permitted for use with the emulator:
Value | |
---|---|
Endpoint | localhost:8081 |
Key | C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw== |
Connection string | AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==; |
Tip
With the Windows (local) emulator, you can also customize the key used by the emulator. For more information, see Windows emulator arguments.
In some cases, you may wish to manually import the TLS/SS certificate from the emulator's running container into your host machine. This step avoids bad practices like disabling TLS/SSL validation in the SDK. For more information, see import certificate.
Events
Jan 14, 8 PM - Feb 25, 7 PM
Azure Cosmos DB Conf 2025 Call for Proposals
Submit your session proposal by Feb. 25th and be part of Azure Cosmos DB Conf 2025.Training
Module
Configure the Azure Cosmos DB for NoSQL SDK - Training
Learn how to configure the Azure Cosmos DB for NoSQL SDK in various ways including how to integrate with the emulator, implement parallelism, and create a custom logger.
Certification
Microsoft Certified: Azure Cosmos DB Developer Specialty - Certifications
Write efficient queries, create indexing policies, manage, and provision resources in the SQL API and SDK with Microsoft Azure Cosmos DB.