MongoDB Atlas Database
Too complicated? Not what you’re looking for?
Consider a hosted Nightscout service! Check for easier solutions here.
MongoDB Atlas Database
MongoDB bought mLab in 2018 and shutdown its service in 2020. Most users migrated to MongoDB Atlas, using a free M0 database with a limited 512MB capacity. Leaving the database grow uncontrolled usually leads to a Nightscout crash.
Pros:
The M0 cluster is free
Nightscout was adapted to MongoDB Atlas
Cons:
M0 clusters are designed for learning and testing, not production
There is no warranty the M0 cluster will remain in the future
A larger M2 cluster costs 9$ per month (consider hosted Nightscout)
A full M0 database crashes Nightscout, this is a common issue for DIY closed loop system users
Note
MongoDB Atlas regularly changes the site aspect. If you encounter a page not matching this documentation search for keywords like not now
, skip
or later
to continue. Report discrepancies here.
Create an Atlas database
a) Open a browser tab at: https://www.mongodb.com/cloud/atlas/register
b) Enter your information, click Continue
then Create account
![../../../_images/NewNS18.png](../../../_images/NewNS18.png)
MongoDB Atlas will send you an email, if you don’t receive it check your Spam folder.
![../../../_images/NewNS18b.png](../../../_images/NewNS18b.png)
In the email you received from MongoDB Atlas (mongodb-atlas @ mongodb.com), click on Verify email
![../../../_images/NewNS18c.png](../../../_images/NewNS18c.png)
Another browser tab will open with your confirmed MongoDB account, Continue
.
![../../../_images/NewNS18d.png](../../../_images/NewNS18d.png)
Enter some information (like below) and click Finish
.
![../../../_images/NewNS18e.png](../../../_images/NewNS18e.png)
c) Select Create a cluster in Shared Clusters (FREE)
![../../../_images/NewNS19.png](../../../_images/NewNS19.png)
If you ever see this, just STOP
We’re building a free cluster: you don’t need to provide any billing information.
d) Check you selected Shared
, leave all default values and click Create Cluster
![../../../_images/NewNS20.png](../../../_images/NewNS20.png)
e) Select Username and Password
and invent a database username (for example nightscout
) and a database password (for example soo5ecret
but please make one that’s yours!).
Database credentials
Do not use your Atlas account credentials. Do not use special characters: only letters and numbers. No spaces.
![../../../_images/NewNS25.png](../../../_images/NewNS25.png)
Write down the password in the line below (yes, in this browser window you’re reading now, unless you’re reading a printed version). You’ll need it later.
Database password (write here ->) |
---|
Then click Create User
.
f) Select My Local Environment
and in the box My IP address
write 0.0.0.0/0
(mind these are all zeroes, not the letter O)
Warning
If you don’t allow access from anywhere (IP 0.0.0.0/0) Nightscout will not be able to access your database.”
![../../../_images/NewNS23.png](../../../_images/NewNS23.png)
Then click Add Entry
.
g) Click on Finish and Close
![../../../_images/NewNS24.png](../../../_images/NewNS24.png)
h) Click on Go to Databases
![../../../_images/NewNS24b.png](../../../_images/NewNS24b.png)
i) Atlas will create your default cluster, it can take more than 3 minutes
![../../../_images/NewNS21.png](../../../_images/NewNS21.png)
j) Click on CONNECT
![../../../_images/NewNS22.png](../../../_images/NewNS22.png)
k) If displayed, click on Choose a connection method
(else skip)
![../../../_images/NewNS26.png](../../../_images/NewNS26.png)
l) Select Drivers
![../../../_images/NewNS27.png](../../../_images/NewNS27.png)
m) Scroll down (do not change any value) and copy the connection string: click Copy
and paste it somewhere to edit it (like Notepad).
![../../../_images/NewNS28.png](../../../_images/NewNS28.png)
n) Paste the string in the line below (yes, in this browser window you’re reading now, unless you’re reading a printed version).
(paste here ->)
Hint
It should be similar to this (xxxxx
will be different):
mongodb+srv://nightscout:<password>@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority
o) (Optional) Invent a name for your database, this is not a critical information (for example myCGMitc
). Only letters and numbers, no spaces.
Database Name (write here ->) |
---|
p) Click on the button Generate
(just here below this line: in this browser window you’re reading):
The connection string will appear here
Warning
Keep this string safely aside, it is called your MONGODB_URI
p) If you want to do it manually: replace <password>
with your database password as noted previously (in the example below soo5ecret
) and <dbname>
by any text you want, say mycgmic
for example. The result will be like this:
mongodb+srv://nightscout:soo5ecret@cluster0.xxxxx.mongodb.net/myCGMitc?retryWrites=true&w=majority
Hint
There should be NO <
and NO >
characters in the final string, neither for password nor for database name.
You have completed a MongoDB Atlas database creation.
Now that you have copied the resulting MONGODB_URI
string to a safe place, go back to the instructions page you were following.