You must migrate your existing mLab MongoDB, where all your Nightscout data are stored, to MongoDB Atlas before November 10th, 2020. This is essential to keep your Nightscout functioning.
This blog shows you some public available resources to get you migrating in under 30 minutes. A last Service Management call to keep using the Nightscout software as usual. Translated automatically to your language here.
First the disclaimer
I am not a healthcare professional. Always consult your doctor before making changes to your diabetes treatment plan. For this blog series, I do not have – and do not want – any sponsorship deals or whatsoever and pay for all equipment just like anybody else.
Table of contents
The blog-specific parts:
- Introduction
- Step-by-step migration
- If you missed the mongo migration to atlas and your site has stopped working
And the general parts:

Blog-specific parts
Introduction
Nightscout is an essential part of AndroidAPS, a Do-It-Yourself-Artificial-Pancreas-System (DIY APS). For most people their Nightscout data is stored on the mLab platform available from within the Heroku platform.
Unfortunately, the mLab team has chosen to discontinue the mLab MongoDB add-on. It will be removed from all Heroku apps on November 10, 2020 (see this mLab discontinuation FAQ or this official mLab announcement).
You must migrate your existing mLab MongoDB, where all your Nightscout data are stored, to MongoDB Atlas before November 10th, 2020. This is essential to keep your Nightscout functioning.
Step-by-step migration
- First update your Nightscout site to the most recent version. Use this Nightscout official manual.
- For the database migration there are several public available resources. My advice is to use option 1 or option 2.
- Nightscout documentation
The Nightscout Foundation published a guide to perform the migration, follow this link. - Terry L. Witt wrote a step by step tutorial which helped me a lot. I have printed it, read it, understand it and started the process. For everybody who has questions on the process it’s much easier asking beforehand than in the middle of it. See this document on Google Drive (starts on page 6).
- mLab official documentation
If you migrate using this method don’t forget to put Heroku in Maintenance mode to prevent database corruption. Open this written guide or watch this video.
- Nightscout documentation
Please remember. It’s a Do-It-Yourself project, not Do-It-Alone. When you need help from the community please visit this section.
If you missed the mongo migration to atlas and your site has stopped working
See this post of Kate Farnsworth in the Looped Facebook group. I suggest to subscribe you for it, very useful!
- Look for an email from mlab. It will list your mLab Admin Username. It will be something like :heroku_b2gmkz2z
- Click the link in that email Reset Password form to reset your mlab password make sure new password doesn’t have any !@#$%^&* special characters. Copy this new password down
- Follow the directions for migration here starting at STEP 2: ATLAS ACCOUNT: http://nightscout.github.io/update/migrate_heroku/#step-2-atlas-account
- When you get to the connect to MLAB part, you will use the Username and password from step 1 & 2.
- Continue with the rest of the directions
General parts
Purpose of this series
The idea of the diabetic patient as a crisis manager is outdated. Using a ‘Do It Yourself Artificial Pancreas System’ (DIY APS) you have less to worry about and can achieve a higher quality of life for yourself and your caregivers. When configured properly, the diabetic person may have a healthy HBA1C value. You can start today!
Our blog series is called ‘our journey: from pen therapy to AndroidAPS, a DIY APS’. This T1D series aims to inform the world on current technical possibilities to bring down the effort on (daily) diabetes management activities and be healthier long term.
Follow this blog series to see how you can make a step-by-step shift from pen therapy to a ‘Do It Yourself Artificial Pancreas System’ (DIY APS). A similar project for Apple smartphones is called Loop project. Welcome to the future.
Need some help?
All DIY APS possibilities are developed by the diabetes community since 2013. Most effort in the online DIY APS community is done by volunteers through a pay-it-forward mechanism. Each participant/volunteer has severe perseverance and the will to contribute to the community in their own field of knowledge. Please feel free to contact me on whatever question you may have and request a membership in Facebook groups AndroidAPSUsers / TheLoopedGroup. Happy to help!
About the author
I am Peter, a millennial born in 1984, living in The Netherlands and hope someone will find a cure for type 1 diabetes (T1D) fast. Since my girlfriend was diagnosed as T1D both of our lives rapidly have changed. I became involved as a volunteer on the AndroidAPS project. I commit my IT Service Delivery Management passion to a more comfortable and healthier diabetes-life because of all automation possible since 2013. As a professional, I feel comfortable to deliver value, overseeing all components while managing staff and costs.
Een reactie op “Only 1 day left: database migration from mLab to Atlas”