MongoDB Setup

Learn how to create your own MongoDB Instance and copy its Connection String.


Create a Free Database

  1. Create an Atlas Account.
  2. Choose a Free Tier Cluster.
  3. Whitelist Your Connection IP Address.
  4. Create a Database User.
    • The User should have Read and Write privileges for the given database (readWrite@<databaseName>).
  5. Connect to Your Cluster.

Copy and Paste the Connection String

  1. Copy your connection string.
    • Found under Connect → Drivers → Add your connection string to your application code
    • Recommended Format: mongodb+srv://<USERNAME>:<PASSWORD>@<CLUSTER_NAME>.<YOUR_URI>.mongodb.net/
  2. In the Configuration Wizard for the FaceTec Server, choose MongoDB in the Database Section.
  3. Click Create & Download the FaceTec Server.
  4. In the FaceTec Server's config.yaml file, paste the MongoDB Connection String into the uri field underneath mongodb:.
    Important Note: The MongoDB Atlas Free-Tier Cluster is only recommended during initial testing. Before moving to Production FaceTec recommends Stress/Load Testing Your Environment, estimating the expected daily usage and TPS to calculate your MongoDB Atlas Cluster throughput, and implementing autoscale to handle peak loads and high traffic periods.
    Important Note: FaceTec recommends using the Default MongoDB URI when connecting to Your FaceTec Server. Using different settings in Your MongoDB Connection String can result in an unsuccessful connection preventing the FaceTec Server from initializing.