Docs Menu

Docs HomeLaunch & Manage MongoDBMongoDB Atlas

Deploy a Federated Database Instance

On this page

  • Required Access
  • Prerequisites
  • Procedure

This page describes how to deploy a federated database instance for accessing data in an HTTP data store.



The support for HTTP data stores is available as a Preview feature. The feature and the corresponding documentation may change at any time during the Preview stage.

To deploy a federated database instance, you must have Project Owner access to the project. Users with Organization Owner access must add themselves as a Project Owner to the project before deploying a federated database instance.

Before you begin, you will need to:

  • Create a MongoDB Atlas account, if you do not have one already.

  • Format your data store using one of the supported data formats.


    If your file format is CSV or TSV, you must include a header row in your data. See CSV and TSV for more information.

  • Make your data store accessible over the public internet.


  • If your HTTP data store is not accessible over HTTPS, you must use the JSON Editor to configure your data store. In your JSON configuration, you must set the stores.[n].allowInsecure setting to true.

  • Atlas Data Federation does not support HTTP data store URLs that require authentication.

  1. Click the Create New Federated Database dropdown.

  2. Select Manual Setup.


You can select AWS or Azure. Once your federated database instance is created, you can't change the cloud provider where Atlas Data Federation processes your queries.


Defaults to FederatedDatabaseInstance[n]. Once your federated database instance is created, you can't change its name.

  • For a guided experience, click Visual Editor.

  • To edit the raw JSON, click JSON Editor.


To add other data stores for federated queries, see:

←  HTTP URLAtlas Data Lake Dataset or Online Archive →