Running RavenDB on Azure

Microsoft’s Azure platform provides excellent data storage facilities in the form of the Windows Azure Storage service, with Table, Blob and Queue stores, and SQL Azure, which is a near-complete SQL Server-as-a-service offering. But one thing it doesn’t provide is a “document database”, in the NoSQL sense of the term.

I saw Captain Codeman’s excellent post on running MongoDB on Azure with CloudDrive, and wondered if Ayende’s new RavenDB database could be run in a similar fashion; specifically, on a Worker role providing persistence for a Web role.

The short answer was, with the current build, no. RavenDB uses the .NET HttpListener class internally, and apparently that class will not work on worker roles, which are restricted to listening on TCP only.

I’m not one to give up that easily, though. I’d already downloaded the source for Raven so I could step-debug through a few other blockers (to do with config, mainly), and I decided to take a look at the HTTP stack. Turns out Ayende, ever the software craftsman, has abstracted his HTTP classes and provided interfaces for them. I forked the project and hacked together implementations of those interfaces built on the TcpListener, with my own HttpContext, HttpRequest and HttpResponse types. It’s still not perfect, but I have an instance running at

My fork of RavenDB is at – the Samples solution contains an Azure Cloud Service and a Worker Role project. My additions to the core code are mainly within the Server.Abstractions namespace if you want to poke around.


My technique for getting Raven running on a worker role differ from the commonly-used methods for third-party software. Generally these rely on running applications as a separate process, getting them to listen on a specified TCP port. With Raven, this is unnecessary since it consists of .NET assemblies which can be referenced directly from the worker project, so that’s how I did it:


The role uses an Azure CloudDrive for Raven’s data files. A CloudDrive is a VHD disk image that is held in Blob storage, and can be mounted as a drive within Azure instances.

Mounting a CloudDrive requires some fairly straightforward, boilerplate code:

private void MountCloudDrive(){var localCache = RoleEnvironment.GetLocalResource("RavenCache");

CloudDrive.InitializeCache(localCache.RootPath.TrimEnd('\\'), localCache.MaximumSizeInMegabytes);

var ravenDataStorageAccount =CloudStorageAccount.Parse(RoleEnvironment.GetConfigurationSettingValue("StorageAccount"));var blobClient = ravenDataStorageAccount.CreateCloudBlobClient();var ravenDrives = blobClient.GetContainerReference("ravendrives");ravenDrives.CreateIfNotExist();var vhdUrl =blobClient.GetContainerReference("ravendrives").GetPageBlobReference("RavenData.vhd").Uri.ToString();

_ravenDataDrive = ravenDataStorageAccount.CreateCloudDrive(vhdUrl);

try{_ravenDataDrive.Create(localCache.MaximumSizeInMegabytes);}catch (CloudDriveException ex){// This exception is thrown if the drive exists already, which is fine.}

_ravenDrivePath = _ravenDataDrive.Mount(localCache.MaximumSizeInMegabytes, DriveMountOptions.Force);}

(This code has been trimmed for size; the actual code involves more exception handling and logging.)

Once the drive is mounted, we can start the server:

private void StartTheServer(){var ravenConfiguration = new RavenConfiguration{AnonymousUserAccessMode = AnonymousUserAccessMode.All,Port = _endPoint.Port,ListenerProtocol = ListenerProtocol.Tcp,DataDirectory = _ravenDrivePath};

_documentDatabase = new DocumentDatabase(ravenConfiguration);_documentDatabase.SpinBackgroundWorkers();

_ravenHttpServer = new HttpServer(ravenConfiguration, _documentDatabase);_ravenHttpServer.Start();}

Again, trimmed for size.

A few points on the configuration properties:

  • the Port is obtained from the Azure Endpoint, which specifies the internal port that the server should listen on, rather than the external endpoint which will be visible to clients;
  • I added a new Enum, ListenerProtocol, which tells the server whether to use the Http or Tcp stack;
  • AnonymousUserAccessMode is set to all. My intended use for this project will only expose the server internally, to other Azure roles, so I have not implemented authentication on the TCP HTTP classes yet;
  • The DataDirectory is set to the path that the CloudDrive Mount operation returned.

I have to sign a contribution agreement, and do some more extensive testing, but I hope that Ayende is going to pull my TCP changes into the RavenDB trunk so that this deployment model is supported by the official releases. I’ll keep you posted.


  1. Did you sign that contribution agreement and submit the patch to Ayende? I'd really like to use this capability of RavenDB and Azure, but would really like to be using the official source rather than a fork.Cheers!

  2. Would be great if this made it into the RavenDb trunk!

  3. James,I have now signed the agreement. I'm going to merge the latest trunk changes (managed storage) and make sure my code still works properly, then I'll submit a pull request.

  4. Hi,

    I was wondering what the status is of this fork, did it made it into the main code base?

    RavenDB would be so much more interesting if it would natively run on Azure.

  5. It became unnecessary after Microsoft made some changes to the Azure role, specifically around elevated privileges and Full IIS. You can take a look at my sample project at to see how to get it up and running, including setting up replication between instances of a role.

    • I don’t comment often but how come so many that have probably never been on a hog farm in their life seem to know so much about raising them? Yes it is all about profit just as it would be if he were growing your organic tomaotes. Actually maybe he is8ï0230;&#823&;.they#»¿ have to use the manure on something you know.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: