How can I run Microsoft Azure DocumentDB locally?

Question

I use a Mac and mostly work on Node.js projects. I would like to try out DocumentDB to compare it against MongoDB. Is there anyway to run a local instance of Azure DocumentDB without going thru the hassles of setting up a real account?

Thanks!

rnrneverdies · Answer 1 · 2016-12-08T13:46:26.670

23

Since Nov 16, 2016 (announcement), you can download the new official DocumentDB emulator.

edited Dec 08 '16 at 13:46

answered Nov 16 '16 at 15:00

rnrneverdies

15,243
9
65
95

2

The OP said they "use a Mac" but the [system requirements](https://learn.microsoft.com/en-us/azure/cosmos-db/local-emulator#system-requirements) on that page say: "Windows Server 2012 R2, Windows Server 2016, or Windows 10". The [docker image](https://learn.microsoft.com/en-us/azure/cosmos-db/local-emulator#running-on-docker) doesn't even work on non-windows: "The Azure Cosmos DB Emulator can be run on Docker for Windows. The Emulator does not work on Docker for Oracle Linux." I haven't been able to find any way to do this with a local instance of CosmosDB on a non-windows machine. :( – gabe Jun 04 '18 at 00:21

score 3 · Answer 2 · answered Jul 06 '15 at 14:53

3

as astaykov mentioned, there is no local instance of DocumentDB available at this time. Your options are to either sign up for an Azure Trial at https://azure.microsoft.com/en-us/pricing/free-trial/ or you can send mail to askdocdb AT microsoft. We are currently running a program where we provide free database accounts (no signup required) for evaluation periods.

Thanks

answered Jul 06 '15 at 14:53

John Macintyre - MSFT

142
2

3

Is there any future plans to run it locally? – Teoman shipahi Dec 30 '15 at 05:08

score 3 · Answer 3 · answered Nov 17 '16 at 08:42

3

You can use the DocumentDB emulator now. Just released yesterday.

Get it here: Use the Azure DocumentDB Emulator for development and testing

answered Nov 17 '16 at 08:42

Lybecker

618
5
16

score 2 · Answer 4 · answered May 26 '16 at 20:18

2

Looks like a local development environment might ship by end of this year (2016) or sooner.

More information is at https://feedback.azure.com/forums/263030-documentdb/suggestions/6328798-standalone-local-instance

answered May 26 '16 at 20:18

kotpal

437
8
11

They have now started development on it. It's happening! – Mathias Lykkegaard Lorenzen Jul 30 '16 at 13:49

score 1 · Answer 5 · answered Jul 04 '16 at 07:37

1

Still not a local solution, but if you sign up for the 'dev essentials' program, you get a 25 USD/month credit for free, forever. If you're a little bit careful this allows to do enough dev/test work in the cloud.

answered Jul 04 '16 at 07:37

jeroenh

26,362
10
73
104

Sajeetharan · Answer 6 · 2018-03-18T11:35:50.500

This is now supported with DocumentDB emulator.

you can download from the above link. Based on Docs,

The DocumentDB Emulator provides a high-fidelity emulation of the DocumentDB service. It supports identical functionality as Azure DocumentDB, including support for creating and querying JSON documents, provisioning and scaling collections, and executing stored procedures and triggers. You can develop and test applications using the DocumentDB Emulator, and deploy them to Azure at global scale by just making a single configuration change.

// Connect to the Azure Cosmos DB Emulator running locally
DocumentClient client = new DocumentClient(new Uri("https://localhost:8081"),"C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==");

You can read more about how to setup Azure CosmosDB on local with VSCODE.

How can I run Microsoft Azure DocumentDB locally?

6 Answers6

Linked