Revision for “Set Up Your Nightscout Website — Deploy to Azure” created on March 8, 2017 @ 17:15:32
Set Up Your Nightscout Website -- Deploy to Azure
It is now easier than ever to create a Nightscout website. A "Deploy to Azure" button (or "Deploy to Heroku") allows a user to make many configuration choices while deploying the site for the first time. You must have already forked the <a href="http://www.nightscout.info/wiki/welcome/set-up-your-nightscout-site-github">CGM-Remote-Monitor repository at Github</a> and <a href="http://www.nightscout.info/wiki/welcome/configuring-the-data-backend">created your mLab database</a> (and database user) to complete these steps. <strong>Be sure you have your mLab connection string information written down.</strong> <h2>Deploy to Azure</h2> <ol><li class="listPad">Go to your CGM-Remote-Monitor repository at <a href="https://github.com">Github</a>. (If you have not yet <a href="http://www.nightscout.info/wiki/welcome/set-up-your-nightscout-site-github">set up your GitHub repository</a>, do that and then return to this page.)</li> <li class="listPad">Click the large "Deploy to Azure" button (if you plan to use Azure; single-click <a href="http://www.nightscout.info/wiki/welcome/set-up-nightscout-using-heroku">deploy to Heroku</a> continues to be available). <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure.png" alt="grilledcheese-deploytoazure" width="400" class="wikiImage" /></a> </li> <li class="listPad">Login at Azure (follow whatever prompts appear to get logged in). (If you do not yet have an Azure account, you should stop, create the Azure account first, separately, and then return to this sequence of steps. It is possible to set up your account at this point, but it may be less confusing if you create the account first.)</li> <li class="listPad">The Deploy to Azure screen will load with all of the options you can configure (at the outset) for your site. (You can change any of these later, as needed.) <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure-panel-step1.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure-panel-step1.png" alt="grilledcheese-deploytoazure-panel-step1" width="468" height="742" class="wikiImage" /></a> </li> <li class="listPad">Make sure the <strong>Subscription</strong> shows <span class="redText">Pay-As-You-Go</span>. (If your account is new, it may instead show the free trial, and you will need to change this before the trial ends.) </li> <li class="listPad">If a <strong>Resource Group</strong> is listed in the dropdown, select it. Otherwise, choose "Create New" and accept or replace the "new" resource group name in the Resource Group Name box.</li> <li class="listPad">Choose your <strong>Site Name</strong>. A default name will <em>already</em> be shown in the box. You can replace this with the name you want. What you enter here will become the "name" of your Nightscout site (and will be the key part of your Nightscout url). <strong>The name of your site can not be changed. If you wish to use a different name later, you will need to create a new site.</strong> <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure-panel-sitename.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploytoazure-panel-sitename.png" alt="grilledcheese-deploytoazure-panel-sitename" width="341" height="76" class="wikiImage" /></a> </li> <li class="listPad">Select the <strong>Site Location</strong> from the dropdown menu. (This location does <em>not</em> need to correlate to your actual geographic location.)</li> <li class="listPad">Make sure "Free" is selected from the <strong>Sku</strong> dropdown. (This is the "free tier" that will help ensure your Nightscout site is free.)</li> <li class="listPad">Enter your mongo (mLab) URI in the <strong>Mongo Connection</strong> box. Your mLab URI will use the syntax shown in this example, but you <strong>must</strong> fill in your OWN information, not the sample values shown here: <span style="color: red; class="redText">mongodb://databaseUserName:databaseUserPassword@ds012345.mlab.com:12345/databaseName</span> For example: <span style="color: red; class="redText">mongodb://sallyuser:firstname.lastname@example.org:12345/mycgm</span> <blockquote class="warning">Note: In March of 2016, mongolab changed to mLab. The syntax above is the new syntax using the mLab format.</blockquote> </li> <li class="listPad">Select mg/dl or mmol from the <strong>Display Units</strong> dropdown.</li> <li class="listPad">Enter your 12-character minimum API SECRET in the <strong>Api Secret</strong> box. You make this passphrase up, but it <em>must</em> be at least 12 characters.</li> <li class="listPad">Many of the other variables on the deployment screen are optional. If you do not know what a variable means, you can consult the readme file or the Grilled Cheese features page for more information.</li> <li class="listPad">The ENABLE variable is prepopulated on this one-step deployment with many commonly used features. <strong>Leave them.</strong> If you need to <em>add</em> something to the values string, leave a space after the last one in the string and type your new value (e.g., <span class="redText">bridge</span> for Dexcom G4 Share/G5 bridge site users or <span class="redText">pushover</span> for those using Pushover notifications).</li> <li class="listPad">In the <strong>Show_plugins</strong> box, "careportal" is prepopulated. Plugins listed in this box are always visible on the site, rather than being visible only if toggled on within the individual browser's settings panel. If you want iage, cage, sage, bwp, rawbg to be "always visible," then list them in this box in a space-delimited list. (Other values can be entered here as well, including bwp, boluscalc, etc.)</li> <li class="listPad">Click the "Next" button. <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-next.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-next.png" alt="grilledcheese-next" width="130" height="53" class="wikiImage" /></a> </li> <li class="listPad">The next screen confirms a "website" will be deployed. Click "Deploy." (If you need to return to the previous screen, click "Setup.") <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploy.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deploy.png" alt="grilledcheese-deploy" width="257" height="59" class="wikiImage" /></a> </li> <li class="listPad">On the next screen, you will see the deployment happen. <strong>Be patient.</strong> <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deployment.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-deployment.png" alt="grilledcheese-deployment" width="475" class="wikiImage" /></a> </li> <li class="listPad">When the deployment is complete (and successful), you will see a final line that has links that allow you to <span class="redText">Manage your site</span> or <span class="redText">Browse to yoursiteURL</span>. Your Nightscout url uses this format: http://<strong><span class="redText">YOURWEBSITENAME</span></strong>.azurewebsites.net. <a href="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-success.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/grilledcheese-success.png" alt="grilledcheese-success" width="475" class="wikiImage" /></a> </li> <li class="listPad">Click your site URL to open your site. If the deployment was successful and your mLab information was correctly entered, you should see a black Nightscout site. (If your site does not yet have data, it will be a black site with time and dashes or time and the word "undefined." <div class="warning"><strong>Note: With the 0.9.0 update, a "profile" is required for you to view your site. </strong>The very first time you visit the site, you will be prompted to create a profile. Enter your API SECRET to authenticate your site. Then, at the minimum, select the time zone and "save" the profile. (You can always edit it later.) Return to another browser window and load your site (or enter your url again in the same window and hit enter). </div> </li> <li>Plugins you "enabled" will need to be toggled on/off in the settings in the browser. When viewing your site, click the three horizontal bars top right, and scroll down to see the plugins. You can check visibility on/off, and then save the settings. If you wish to have certain plugins always visible, you can set the <span class="redText">SHOW_PLUGINS</span> variable with the value being the plugins you want visible. For example: <span class="redText">SHOW_PLUGINS</a>=<span class="redText">careportal iob cob sage iage cage</span>. <a href="http://www.nightscout.info/wp-content/uploads/2016/10/showplugins.png"><img src="http://www.nightscout.info/wp-content/uploads/2016/10/showplugins.png" alt="showplugins" width="338" height="511" class="wikiImage" /></a> </li> <li class="listPad"> If you have not yet installed and configured your uploader app, do so now. (If you are using a cabled rig, this means setting up the Nightscout app. If you are using another uploader <strong>or configuring the bridge</strong>, return to the core directions for your specific setup and continue with the next step.) You will <strong>not</strong> see data on your Nightscout site until the uploader app (or bridge) is configured.</blockquote></li> <li><strong>Note for those using older uploaders, including Medtronic</strong>: A change in the 0.9.0 release may affect users of older uploader apps. If your site does not receive data, you may need to set the following variable in Azure (or Heroku): <span class="redText">AUTH_DEFAULT_ROLES</span>=<span class="redText">readable devicestatus-upload</span></li> </ol> <a name="siteloads"></a> <a name="sitefree"></a> <h2>Confirm Your Site is Configured as a FREE Site</h2> If your account is new and you did not choose Pay-As-You-Go during setup, you have 30 days in which to convert the site to Pay-As-You-Go. <strong>We recommend you double-check your site settings by reviewing the following:</strong> <ul> <li class="listPad">Confirm the Subscription type is set to Pay-As-You-Go.</li> <li class="listPad">Confirm the Pricing Tier is set to Free.</li> </ul> <a href="http://www.nightscout.info/wp-content/uploads/2014/08/azure-new-reviewfree.png"><img src="http://www.nightscout.info/wp-content/uploads/2014/08/azure-new-reviewfree.png" alt="azure-new-reviewfree" width="400" class="wikiImage" /></a> Directions to confirm your account is properly configured so that it is free (with typical usage) see: <a title="Azure Management" href="http://www.nightscout.info/wiki/faqs-2/azure-management">Azure Management</a>. <h2>Learn More About Your Nightscout Site</h2> To learn about your website's features click <a href="http://www.nightscout.info/wiki/welcome/website-features/0-9-features">here</a>. There are many customizable features, such as high and low alarms, high and low alerts (for warning of an approaching high/low), and other custom settings. You also can enable a range of plugins, including CarePortal, IOB (insulin on board), COB (carbs on board), CAGE (cannula age), and more.