Nightscout with iOS and Dexcom Share (Bridge)

26 Sep

Revision for “Nightscout with iOS and Dexcom Share (Bridge)” created on December 30, 2017 @ 21:58:43

Title
Nightscout with iOS and Dexcom Share (Bridge)
Content
<h2>Nightscout Bridge (for Dexcom G4 with Share or Dexcom G5)</h2> Users with a Dexcom G4 Share who are using iOS and the Dexcom Share 2 app and users with the Dexcom G5 can still set up a Nightscout site. This is referred to as a Nightscout Bridge. <h2>Limitations of a Nightscout Bridge</h2> Setting up a Nightscout site offers an iOS/Share user almost all features available with Nightscout, except for <a href="http://www.nightscout.info/wiki/labs/interpreting-raw-dexcom-data">"raw data" and "noise"</a>. <h2>Setting Up a Nightscout site with a Nightscout Bridge</h2> Prior to the Funnel Cake (0.8+) release of the Nightscout CGM Remote Monitor code, setting up a Nightscout Bridge required setting up a Nightscout site and a separate bridge application. With Funnel Cake, the bridge can be configured as part of a Nightscout site. To set up a Nightscout site and bridge, you will need to do the following parts of a traditional Nightscout setup. Please refer to the setup directions for each stage of setup linked below,<strong> ignoring references to the "uploader."</strong> iOS Share users do <strong>not</strong> have a Nightscout (or xdrip) uploader. References to the uploader are <strong>not</strong> related to this setup. The following steps link into the relevant sections of setup directions that were <strong>not</strong> written for Share or G5 users. <strong>Set up the parts listed below, and return here for the next steps.</strong> You will be doing the following steps: <ul> <li>Create a Github account and a copy of the CGM-Remote-Monitor</li> <li>Create an Azure <em>or</em> Heroku site.</li> <li>Create a Mongolab account and database. (Azure users only; this step is automated with Heroku.)</li> <li>Configure your site's connection strings (mongo information). (Azure users only)</li> <li>Set the bridge variables (<span class="redText">BRIDGE_USER_NAME</span> and <span class="redText">BRIDGE_PASSWORD</span>).</li> <li>If you are outside of the U.S., set the <span class="redText">BRIDGE_SERVER</span> variable.</li> <li>Configure the ENABLE variable with the value <span class="redText">bridge</span>.</li> <li>Deploy your site using the Github repository.</li> <li>Create an Uptime Robot account.</li> </ul> <strong>Note:</strong> Your G4 with Share or G5 <strong>must</strong> be configured to "share" in order for a Nightscout bridge site to get data. If you need help setting up the G5 share feature, see <a href="/wiki/welcome/nightscout-with-ios-and-dexcom-share/nightscout-bridge-for-dexcom-g5">this document</a>. <ol> <ol> <li style="padding-bottom: 10px;"><strong>Github</strong> Your Github account allows you to create a personal copy of the Nightscout code. You will use this copy in the creation of your website. When updates are released for the code, you will return to Github to update your copy.To begin, set up a free account at <a href="https://www.github.com">www.github.com</a> and then create a copy of the CGM-remote-monitor repository, as follows: <blockquote> <ul> <li>Sign up for a free account at <a href="https://github.com/" target="_blank">github.com</a>. You will see the following screen that confirms you have a free account: <a href="http://www.nightscout.info/wp-content/uploads/2014/08/github-setup1.jpg"><img class=" aligncenter wp-image-1750 size-thumbnail" src="http://www.nightscout.info/wp-content/uploads/2014/08/github-setup1-150x150.jpg" alt="github setup" width="150" height="150" /></a></li> <li><span style="color: red;"><strong>WRITE DOWN YOUR USERNAME &amp; PASSWORD</strong></span>.</li> <li>After creating your account and are logged in, open the master repository by clicking here -&gt; <a href="https://github.com/nightscout/cgm-remote-monitor" target="_blank">cgm-remote-monitor</a></li> <li>Make a copy ("Fork") of the nightscout/cgm-remote-monitor to your own repository by clicking on the '<strong>Fork</strong>' button on top right OR - just click here -&gt; <a href="https://github.com/nightscout/cgm-remote-monitor/fork"><img src="http://i.imgur.com/gR4wJ24.png" alt="fork" /> the cgm-remote-monitor</a></li> <li>When prompted with '<strong><em>Where should we fork this repository?</em></strong>', select your <strong>@&lt;gitaccountname&gt;</strong>, and it will Fork to your repository. At the top of the page, you will now see <strong>&lt;gitaccountname&gt;/cgm-remote-monitor</strong> indicating you have your own copy forked from Nightscout.</li> </ul> </blockquote> </li> <li class="listPad"><strong>Create an Azure or Heroku Website</strong>Your website will be the website you use to view your Nightscout data. The url for this website will also be used if you use a Pebble watch to access your Nightscout data. <strong>To set up your Nightscout website using Heroku</strong>, follow <a href="http://www.nightscout.info/wiki/welcome/set-up-nightscout-using-heroku">these directions</a>. <strong>To set up your Nightscout website using Azure</strong>, follow Step 2 on this page: <a href="http://www.nightscout.info/wiki/welcome/monitor-cgm-web#azure">Create an Azure Website</a> and follow the step below to set up an Mlab account and database. &nbsp;</li> <li style="padding-bottom: 10px;"><strong>Mlab</strong><strong>Note: This step is not necessary if you are using Heroku. Setting up a separate Mlab account and database is only required for Azure sites.</strong> Set up a free sandbox account at <a href="http://www.mongolab.com/plans">www.mongolab.com</a>, and create a user and database <a href="http://www.nightscout.info/wiki/welcome/configuring-the-data-backend">specified here</a>. Be sure to write down all the names and passwords as this information is required in the next steps.</li> <li class="listPad"><strong>Deploy the GitHub Code to Your Azure Website</strong>Follow Step 3 on this page: <a href="http://www.nightscout.info/wiki/welcome/monitor-cgm-web#deploy">Deploy GitHub Code to Azure</a>.</li> <li><strong>Configure the Mongo (Mlab) Portion of the Azure Site</strong>Follow Step 4 on this page: <a href="http://www.nightscout.info/wiki/welcome/monitor-cgm-web#configure"> Configure Your Website to Use Mongo (Mlab)</a>. After completely setting up your website and verifying that you see a black Nightscout website with time and dashes, return to this page to configure the bridge portion of your site. <strong>Note:</strong> make sure you carefully follow the directions to create the site, deploy the Github repository, and enter the necessary mongo strings.</li> </ol> </ol> <a name="configurebridge"></a> <ol> <li class="listPad"><strong>Configure the Bridge</strong>To set up the integrated bridge variables, take the following steps in Azure: <blockquote class="warning"><strong>Note:</strong> The directions below have been updated to reflect the user interface in the new Azure portal.</blockquote> <ul> <li class="listPad">From within your Azure dashboard, click <span class="redText">All settings</span> to open the <span class="redText">Settings</span> panel.</li> <li class="listPad">From the Settings menu, click <span class="redText">Application Settings</span>. <a href="http://www.nightscout.info/wp-content/uploads/2014/08/azure-new-appsettings2.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2014/08/azure-new-appsettings2.png" alt="azure-new-appsettings2" width="150" /></a></li> <li class="listPad">Scroll down to App Settings. <strong>If you do not already have the ENABLE variable from a pre-existing site</strong>, in the first blank box, type <span style="color: red;">ENABLE</span>. In the box next to it, enter <span style="color: red;">bridge</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-enable.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-enable.png" alt="newazure-bridge-enable" width="350" height="48" /></a><strong>Note:</strong> If you already had a Nightscout website, you may already have an ENABLE variable in your settings. You can only have one instance of the ENABLE variable. You can add <span style="color: red;">bridge</span> to your existing value. For example: <span style="color: red;">careportal bridge</span>.</li> <li style="padding-bottom: 10px;"><strong>If you are outside of the U.S.</strong>: On the next blank line, type <span style="color: red;">BRIDGE_SERVER</span>. In the box next to it, enter <span class="redText">EU</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-EU.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-EU.png" alt="newazure-bridge-EU" width="350" height="40" /></a></li> <li class="listPad">Scroll down to <span class="redText">Connection Strings</span>.</li> <li class="listPad">Your mongo strings should already be in place. On the next blank row, type <span style="color: red;">BRIDGE_USER_NAME</span> in the first box. In the box next to it, enter the username for your Dexcom Share (or G5) account. Select "custom" as the type from the dropdown menu. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-user.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-user.png" alt="newazure-bridge-user" width="396" height="48" /></a></li> <li class="listPad">On the next blank line, type <span style="color: red;">BRIDGE_PASSWORD</span>. In the box next to it, enter the password for your Dexcom Share account. Select "custom" as the type from the dropdown menu. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-password.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2015/09/newazure-bridge-password.png" alt="newazure-bridge-password" width="389" height="42" /></a></li> <li class="listPad">At the top of the panel, click the icon to save your changes. <a href="http://www.nightscout.info/wp-content/uploads/2016/09/newazure-save.png"><img class="wikiImage" src="http://www.nightscout.info/wp-content/uploads/2016/09/newazure-save.png" alt="newazure-save" width="234" height="117" /></a></li> </ul> <!-- <ul> <li style="padding-bottom: 10px;">In Azure, on the "Configure" tab, scroll down to App Settings. In the first blank box, type <span style="color: red;">ENABLE</span>. In the box next to it, enter <span style="color: red;">bridge</span>. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/bridge-enable.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/bridge-enable.png" alt="bridge-enable" width="566" height="29" class="alignnone size-full wp-image-2869" style="padding-top: 10px; padding-bottom: 10px;" /></a> <strong>Note:</strong> If you already had a Nightscout website, you may already have an ENABLE variable in your settings. You can only have one. You can add <span style="color: red;">bridge</span> to your existing value. For example: <span style="color: red;">careportal bridge</span>.</li> <li style="padding-bottom: 10px;"><strong>If you are outside of the U.S.</strong>: On the next blank line, type <span style="color: red;">BRIDGE_SERVER</span>. In the box next to it, enter <span class="redText">EU</span>. (This is necessary for those in Canada as well.) <a href="http://www.nightscout.info/wp-content/uploads/2015/09/share-bridgeserver.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/share-bridgeserver.png" alt="share-bridgeserver" width="288" height="49" class="wikiImage" /></a></li> <li style="padding-bottom: 10px;">Scroll down to Connection Strings. In the first blank box, type <span style="color: red;">BRIDGE_USER_NAME</span> in the first box. In the box next to it, enter the username for your Dexcom Share account. Select "custom" as the type from the dropdown menu.</li> <li style="padding-bottom: 10px;">On the next blank line, type <span style="color: red;">BRIDGE_PASSWORD</span>. In the box next to it, enter the password for your Dexcom Share account. Select "custom" as the type from the dropdown menu.<a href="http://www.nightscout.info/wp-content/uploads/2015/09/bridge-vars.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/bridge-vars.png" alt="bridge-vars" width="655" height="67" class="alignnone size-full wp-image-2870" style="padding-top: 10px; padding-bottom: 10px;" /></a></li> </ul> At the bottom of the screen, click <strong>save</strong>. --></li> <li style="padding-bottom: 10px;"><strong>Verify that the Account Works</strong>In a browser, go to your site: <span style="color: red;">http://YOURSITE.azurewebsites.net</span>. If your deployment and configuration of your bridge was successful, you will see a black screen with the time and your current CGM data. If you do not see a black screen, your deployment may have failed. You may also have an error in the entry of the mongo connection strings. If you do not see data but see a black screen with the time and date, wait five minutes and reload the page. If you still do not have data, there may be a problem with your Dexcom user variables or you may have an error in the entry of your mongo connection strings. <a name="uptimerobot"></a></li> <li style="padding-bottom: 10px;"><strong>Set Up Uptime Robot</strong> Both Azure and Heroku bridge sites require Uptime Robot to keep the Nightscout Bridge site working properly. (Users of the bridge in Funnel Cake reported gaps when the site was not continuously being accessed. Uptime Robot solves this problem.)Create a free account at <a href="https://uptimerobot.com">Uptime Robot</a> and set up a "monitor" for your website. It will look similar to this: <a href="http://www.nightscout.info/wp-content/uploads/2015/09/uptimerobot2.png"><img class="alignnone size-full wp-image-2859" src="http://www.nightscout.info/wp-content/uploads/2015/09/uptimerobot2.png" alt="uptimerobot2" width="627" height="323" /></a> (Note: You can name it anything you want in the "Friendly Name" box. This just helps you identify it in your own account. Your site URL goes in the URL box.)</li> <li style="padding-bottom: 10px;"><strong>Switch to Pay-as-You-Go</strong></li> <li style="padding-bottom: 10px;">See <a href="http://www.nightscout.info/wiki/faqs-2/azure-2/azure-management">this document</a> for important information about changing your Azure account to Pay-as-You-Go.</li> </ol> Once your site is working, learn more about other features you can customize and get a better understanding of your site in these resources: <ul> <li><a href="http://www.nightscout.info/wiki/welcome/website-features">Your Nightscout Website Features</a>: important information about your site, including how to customize thresholds and basic alarms.</li> <li><a href="http://www.nightscout.info/wiki/welcome/website-features/funnel-cake-0-8-features">Funnel Cake (0.8+) Features</a>: rundown of features new in Funnel Cake, including BWP, enhanced Pushover, IFTTT, and more.</li> <li><a href="http://www.nightscout.info/archives/2753">What's On a Nightscout Site?</a>: this diagram helps explain the visual elements of a Nightscout site.</li> </ul>
Excerpt


OldNewDate CreatedAuthorActions
December 30, 2017 @ 21:58:43 Kate Farnsworth
December 30, 2017 @ 21:58:37 Kate Farnsworth
December 30, 2017 @ 21:57:27 Kate Farnsworth
December 30, 2017 @ 21:48:28 Kate Farnsworth
December 30, 2017 @ 21:30:25 Kate Farnsworth
September 21, 2017 @ 23:06:35 Amy Cowen
April 20, 2017 @ 14:46:11 Amy Cowen
April 20, 2017 @ 14:45:40 [Autosave] Amy Cowen
April 20, 2017 @ 14:44:22 Amy Cowen
March 30, 2017 @ 10:50:55 Amy Cowen
March 29, 2017 @ 17:18:40 Amy Cowen
March 29, 2017 @ 13:08:52 Amy Cowen
October 14, 2016 @ 00:55:35 Amy Cowen
September 12, 2016 @ 10:12:34 Amy Cowen
September 12, 2016 @ 10:11:43 Amy Cowen
August 23, 2016 @ 22:01:31 Amy Cowen
August 23, 2016 @ 21:59:29 Amy Cowen
April 14, 2016 @ 23:38:08 Amy Cowen
April 14, 2016 @ 23:33:13 Amy Cowen
April 14, 2016 @ 23:06:44 Amy Cowen
February 24, 2016 @ 20:05:13 Amy Cowen
February 24, 2016 @ 19:58:40 Amy Cowen
February 24, 2016 @ 19:57:23 Amy Cowen
January 15, 2016 @ 15:15:54 Amy Cowen
January 11, 2016 @ 22:59:08 Amy Cowen
January 11, 2016 @ 22:11:08 Amy Cowen
January 11, 2016 @ 22:05:39 Amy Cowen
December 29, 2015 @ 09:14:40 Amy Cowen
December 29, 2015 @ 09:13:04 Amy Cowen
December 29, 2015 @ 09:10:00 Amy Cowen
December 29, 2015 @ 09:07:28 Amy Cowen
December 21, 2015 @ 18:10:10 Amy Cowen
December 21, 2015 @ 18:09:03 Amy Cowen
December 9, 2015 @ 15:23:49 Amy Cowen
December 9, 2015 @ 15:22:52 Amy Cowen
September 26, 2015 @ 21:00:02 Amy Cowen
September 26, 2015 @ 19:19:53 Amy Cowen
September 26, 2015 @ 19:18:44 Amy Cowen
September 26, 2015 @ 19:17:30 Amy Cowen
September 26, 2015 @ 19:16:18 Amy Cowen
September 26, 2015 @ 19:11:56 Amy Cowen
September 26, 2015 @ 19:01:05 Amy Cowen
September 26, 2015 @ 18:59:59 Amy Cowen
September 26, 2015 @ 18:58:39 Amy Cowen
September 26, 2015 @ 18:53:30 Amy Cowen
September 26, 2015 @ 18:52:40 Amy Cowen
September 26, 2015 @ 18:47:20 Amy Cowen
September 26, 2015 @ 18:13:12 Amy Cowen