NS 15 updates

docs/nightscout/security.md

@@ -126,4 +126,9 @@ In order to make your site visible to anybody, set  [`AUTH_DEFAULT_ROLES`](/nigh
 
 ## Developers: API authorization
 
-See [this page](https://github.com/nightscout/cgm-remote-monitor/wiki/API-v1-Security) for how to authenticate your app in the API calls.
+See [this page](https://github.com/nightscout/cgm-remote-monitor/wiki/API-v1-Security) for how to authenticate your app in the API V1 calls.
+
+The API documentation is visible on your Nightscout site using this extension to your site address:
+
+https://YOUR-SITE.com/api-docs/ and https://YOUR-SITE.com/api3-docs/.
+

docs/nightscout/setup_variables.md

@@ -55,6 +55,7 @@ Nightscout configuration is held in variables , their content can be modified to
 The connection string required to access your database (where all your data is stored in the cloud).
 
 ```{warning}
+**`MONGODB_URI` is handled automatically if you use a hosted service or Google Cloud xDrip+ method.** In these cases you don't need to worry about it and can't or shouldn't change it.</br>
 This string is vital to your Nightscout functioning. A wrong connection string will prevent your site from opening and your data uploading in Nightscout.
 ```
 
@@ -87,7 +88,8 @@ MyV3ry53cr37
 ```
 
 ```{hint}
-This is the passcode that will be required by the uploader app (if any) to send data to your site, and that will allow you to modify your site parameters from the web interface. Keep it secret, only share it with trusted people, change it if you believe it's been exposed publicly. Minimum length is 12 characters, don't make it too long and **do not put special characters in it** (better stick to letters and numbers). It is case-sensitive.
+Don't make it too long and **do not put special characters in it** (better stick to letters and numbers).</br>It is case-sensitive.</br>
+If you need to share Nightscout access but control the access, use an `admin` [token](/nightscout/security.md#create-authentication-tokens-for-users).
 ```
 
 </br>

docs/nightscout/tokens.md

@@ -46,6 +46,10 @@ There is currently no way to limit a user so that he cannot view the Reports sec
 
 <img src="/nightscout/img/Admin05.png" width="600px" />
 
+- An `admin` token is necessary for AAPS to upload using the API V3.
+
+<img src="/nightscout/img/Admin05b.png" width="300px" />
+
 </br>
 
 - Click save.
@@ -64,11 +68,11 @@ You can also add the token to the site URL to authenticate using a token. Your s
 Anybody with this link can use your Nightscout with the role defined for this token.
 
 ```{hint}
-If the user copies only your core URL into a browser, and your site is readable by default, the token will be bypassed. (Possible strategies to ensure the user puts the role-based URL into a browser include using a tinyurl or bit.ly.)
+If the user copies only your core URL into a browser, and your site is readable by default, the token will be bypassed. (Possible strategies to ensure the user puts the role-based URL into a browser include using a [tinyurl]<https://tinyurl.com/app> or [bit.ly]<https://bitly.com/>.)
 ```
 
 - You can edit a subject by clicking the edit icon, making changes, and saving.
-- You can delete a subject by clicking the “x” icon to remove the subject from the list.
+- You can delete a subject by clicking the red **`X`** icon to remove the subject from the list.
 
 See [how to setup your downloaders (followers)](/nightscout/downloaders) with a secured site.
 

docs/nightscout/wizard.md

@@ -7,23 +7,15 @@
 This set of questions will hopefully help choose the best solution for you, or at least give you hints on where to start. 
 
 ```{hint}
-*This wizard is thought for one Nightscout site (one patient with diabetes). If you need more Nightscout sites you might need more accounts. Some hosted providers provide discounts and T1Pal support up to 5 patients per subscription.*
-```
-
-```{admonition} Nightscout DIY rules
-:class: note
-If it's cheap and easy it might not be as reliable as you'd like  
-If it's cheap and reliable it might be difficult to build or maintain  
-If it's simple and reliable it might not be free  
-**Free, simple and reliable is not available.**
+*This wizard is thought for one Nightscout site (one patient with diabetes). If you need more Nightscout sites you might need more accounts. Some hosted providers provide discounts, T1Pal support up to 5 patients per subscription.*
 ```
 
 </br>
 
 | I want to contribute to Nightscout research and development.</br><select name="cont" id="CONT"><br/>  <option value="yes">Yes</option><br/>  <option value="no" selected="selected">No</option><br/></select> |
 | ------------------------------------------------------------ |
 | **What is the maximum acceptable cost per month  per site?**</br><select name="cost" id="COST"><br/>  <option value="free">It MUST be free even if it requires a lot of work</option><br/>  <option value="cent" selected="selected">Less than 10c</option><br/>  <option value="pay1">Less than 6$</option><br/>  <option value="pay2">Less than 10$</option><br/>  <option value="pay3">Less than 15$</option><br/></select> |
-| **How much of an issue is it when Nightscout is down?**</br><select name="rely" id="RELY"><br/>  <option value="serious">Serious: I need it back up ASAP</option><br/>  <option value="mild">Disturbing: If I can get it back up in less than a week I'm ok</option><br/>  <option value="none" selected="selected">It happens: I'll do without until I can get it fixed</option><br/></select> |
+| **How much of an issue is it when Nightscout is down?**</br><select name="rely" id="RELY"><br/>  <option value="serious">Serious: I need someone to fix it ASAP</option><br/>  <option value="mild" selected="selected">Disturbing: I will look for help and try to fix it myself</option><br/></select> |
 | **How much time are you ready to spend on creating and maintaining it?**</br><select name="simple" id="SIMPLE"><br/>  <option value="high">I've got good IT knowledge</option><br/>  <option value="medium" selected="selected">I can follow detailed instructions and take care of it</option><br/>  <option value="easy">I can follow simple instructions and take care of it</option><br/>  <option value="pay">I want someone else to do it for me</option><br/></select> |
 
 <script>
@@ -67,9 +59,8 @@ function Validate()
 	sel = document.getElementById("RELY");
 	switch(sel.selectedIndex)
 	{
-		case 0: nsHero=0; dbAtla=0; dbRail=0; dbVPS=0; nsFly=0; nsRend=0; nsGoog=0; nsVPS=0; break
-		case 1: nsFly=0; break
-		case 2: break
+		case 0: nsHero=0; dbAtla=0; dbRail=0; dbVPS=0; nsFly=0; nsRend=0; nsGoog=0; nsVPS=0; nsFly=0; break
+		case 1: break
 	}
 	if(dbAtla) sDB=sDB+" - Free MongoDB Atlas (limited to 512MiB) <br />"
 	if(dbAtlaP) sDB=sDB+" - M2 MongoDB Atlas (9$/month) <br />"
@@ -105,6 +96,7 @@ function Validate()
 
 
 
+
 </br>
 
 Now click SHOW below to validate your choices.  

docs/uploader/setup.md

@@ -66,10 +66,10 @@ You can find it in [Status - Hostname](https://navid200.github.io/xDrip/docs/Nig
 
 ## Dexcom
 
-You need at least one follower to use Dexcom Share.
+You need at least one follower to use Nightscout `share` or `nightscout-connect` plugins.
 
 ```{hint}
-If you use a DIY closed loop system it is recommended that you let it upload to Nightscout instead of importing data using Dexcom Share and the `bridge` plugin.
+If you use a DIY closed loop system it is recommended that you let it upload to Nightscout instead of importing data using Dexcom Share and a Nightscout plugin.
 ```
 
 On your master phone, touch the Share icon, enable Sharing. If you have no follower, add one. You can also invite yourself.
@@ -78,13 +78,32 @@ On your master phone, touch the Share icon, enable Sharing. If you have no follo
 
 </br>
 
-Verify, update or add these variables:
+```{tab-set}
 
-`BRIDGE_USER_NAME 
-BRIDGE_PASSWORD 
-BRIDGE_SERVER`
+:::{tab-item} Select Nightscout version ->
+</br>
+:::
 
+:::{tab-item} 14 and previous
+Verify, update or add these variables:</br></br>
+`BRIDGE_USER_NAME`</br>
+`BRIDGE_PASSWORD`</br>
+`BRIDGE_SERVER`</br>
+</br>
 You need to add `bridge` in the `ENABLE` variable. Do not delete other entries, just add `bridge` after a space.
+:::
+
+:::{tab-item} 15
+Verify, update or add these variables:</br></br>
+`CONNECT_SOURCE` set to `dexcomshare`</br>
+`CONNECT_SHARE_ACCOUNT_NAME`</br> 
+`CONNECT_SHARE_PASSWORD`</br> 
+`CONNECT_SHARE_SERVER` (must be set to `ous` if outside of the US, else don't add this variable)</br>
+</br>
+You need to add `connect` in the `ENABLE` variable. Do not delete other entries, just add `connect` after a space.
+:::
+
+```
 
 </br>
 
@@ -103,14 +122,40 @@ The most common error on initial Nightscout setups is that people incorrectly us
 ## Medtronic CareLink
 
 ```{warning}
-The `mmconnect` plugin is **NOT** functional anymore with recent pumps (7xx) in cloud Nightscout sites.
+The `mmconnect` plugin is **NOT** functional anymore with recent pumps (7xx).
 ```
 
-```{hint}
-A new [plugin](/nightscout/plugins-v15/) is under test with the development branch of Nightscout... stay tuned!
-```
+You can use an Android phone with xDrip+. See [**here**](../../uploader/xdripcarelink) how to set it up.
+
+</br>
+
+```{tab-set}
+
+:::{tab-item} Select Nightscout version ->
+</br>
+:::
+
+:::{tab-item} 14 and previous
+Verify, update or add these variables:</br></br>
+`CARELINK_USER_NAME`</br>
+`CARELINK_PASSWORD`</br>
+`MMCONNECT_SERVER`(must be set to `US` if inside the US, or else `EU`)</br>
+</br>
+You need to add `mmconnect` in the `ENABLE` variable. Do not delete other entries, just add `mmconnect` after a space.
+:::
+
+:::{tab-item} 15
+Verify, update or add these variables:</br></br>
+`CONNECT_SOURCE` set to `minimedcarelink`</br>
+`CONNECT_CARELINK_USERNAME`</br> 
+`CONNECT_CARELINK_PASSWORD`</br> 
+`CONNECT_CARELINK_REGION` (must be set to `us` if inside the US, or else `eu`)</br>
+`CONNECT_CARELINK_PATIENT_USERNAME` must be set to the patient name if more than one in present in Carelink.</br>
+</br>
+You need to add `connect` in the `ENABLE` variable. Do not delete other entries, just add `connect` after a space.
+:::
 
-You can use an Android phone with a private version of xDrip+. See [**here**](../../uploader/xdripcarelink) how to set it up.
+```
 
 </br>
 

docs/uploader/uploaders.md

@@ -11,11 +11,11 @@ If you're developing an uploader, you'll find the API information in your own Ni
 
 ## Dexcom
 
-### Dexcom G5/G6/ONE
+### Dexcom G5/G6/ONE/G7
 
 <img src="./img/Upload02.png" width="600px" />
 
-If you are using the Dexcom G5 and G6 sensors connected to the Dexcom app on your phone, it will upload directly to the Dexcom servers (also still known as "Dexcom Share") and you won't need to use any extra uploader or master device.  
+If you are using the Dexcom sensor (except ONE) connected to the Dexcom app on your phone, it will upload directly to the Dexcom servers (also still known as "Dexcom Share") and you won't need to use any extra uploader or master device.  
 
 ```{note}
 Dexcom Share is not available with Dexcom ONE. Use xDrip+ or xDrip4iOS.
@@ -27,11 +27,11 @@ For this to work, Nightscout must be configured to use the `bridge` plug-in and
 If you use a [DIY closed loop system](/nightscout/close_loop) it is recommended that you let it upload to Nightscout instead of importing data using Dexcom Share and the `bridge` plugin.
 ```
 
-*Please note that at this time (early 2023), the Dexcom G5 system is effectively obsolete but some people are still using stocks of old sensors and transmitters.*
+*Please note that at this time (end 2023), the Dexcom G5 system is effectively obsolete but some people are still using stocks of old sensors and transmitters.*
 
-If you don't want to use the official Dexcom apps, then you can use **open-source software** apps for your Dexcom sensor to connect, display, alarm and also upload to Nightscout:
+If you don't want to use the official Dexcom apps, you can use **open-source software** apps for your Dexcom sensor to connect, display, alarm and also upload to Nightscout:
 
-**Android**: xDrip+ for G5, G6 and ONE. <!-- xDrip+ for G4 (1)(2)(3), G5 and G6. -->
+**Android**: xDrip+ for G5, G6, ONE and G7. <!-- xDrip+ for G4 (1)(2)(3), G5 and G6. -->
 
 **iOS**:   
 	Spike for G5 and older G6 transmitters (**not Firefly**) <!-- Spike or xDrip4iOS for G4 (1)(3) -->  
@@ -46,11 +46,9 @@ Most of the useable transmitters that fall into this category at the present tim
 
 ## Medtronic
 
-If your sensor system is able to directly upload to CareLink then Nightscout might be able to get the information directly from the cloud using the `mmconnect` plugin. Unfortunately, this is **not possible anymore with recent pumps (7xx series and above)**.
+If your sensor system is able to directly upload to CareLink then Nightscout might be able to get the information directly from the cloud using the `mmconnect` (deprecated) plugin. Unfortunately, this is **not possible anymore with recent pumps (7xx series and above)**.
+
 
-```{hint}
-A new [plugin](/nightscout/plugins-v15/) is under test with the development branch of Nightscout... stay tuned!
-```
 
 <img src="./img/Upload04.png"  width="600px"/>
 
@@ -86,10 +84,12 @@ Most of the transmitters have their own proprietary apps. Nearly all of these su
 You can connect to the Libre 2 sensor (**EU only**) without an additional transmitter using [xDrip+](https://www.minimallooper.com/post/how-to-setup-freestyle-libre-2-and-oop2-to-use-a-native-bluetooth-connection-in-xdrip), and [xDrip4iOS](https://xdrip4ios.readthedocs.io/en/latest/connect/cgm/#libre).  
 Other Libre 2 sensors can be used directly with [Juggluco](http://jkaltes.byethost16.com/Juggluco/mgdL/index.html) and Diabox.
 
-### Libre 3
+### Libre 2/3
 
 You can use the sensor connected with [Juggluco](http://jkaltes.byethost16.com/Juggluco/mgdL/index.html) or upload to Nightscout automatically from LibreView servers deploying [this](https://github.com/timoschlueter/nightscout-librelink-up) project, or use xDrip+ to perform this operation.
 
+A new plugin in Nightscout 15 (under development) will integrate the project above.
+
 ## Eversense
 
 In order to get data from the Eversense CGM system, you will need to use the [ESEL](https://github.com/BernhardRo/Esel/releases) app running on an Android phone with the [modified](https://cr4ck3d3v3r53n53.club/) vendor app.
@@ -98,4 +98,6 @@ In order to get data from the Eversense CGM system, you will need to use the [ES
 
 ## Diasend
 
-[disaend-nightscout-bridge](https://github.com/burnedikt/diasend-nightscout-bridge) synchronizes treatments (insulin boli, temp basal changes) as well as continuous glucose values (CGV) from Diasend to Nightscout. This can help CamAPS FX users to view their treatments and glucose values via Nightscout. A 30 minutes delay might occur.
+[disaend-nightscout-bridge](https://github.com/burnedikt/diasend-nightscout-bridge) synchronizes treatments (insulin boli, temp basal changes) as well as continuous glucose values (CGV) from Diasend to Nightscout. This can help CamAPS FX users to view their treatments and glucose values via Nightscout. A 30 minutes delay might occur.
+
+A new plugin in Nightscout 15 (under development) will integrate the project above.

docs/vendors/VPS/docker.md

@@ -178,6 +178,20 @@ Note that you need to start it if you modify your `docker-compose.yml` configura
 
 </br>
 
+## Update or downgrade
+
+Edit your `docker-compose.yml` configuration and change the image to whichever you want in the [community maintained images](https://hub.docker.com/r/nightscout/cgm-remote-monitor/tags).
+
+If you're using `image: nightscout/cgm-remote-monitor:latest` and you want to upgrade it to latest release, don't change anything. You can update to `cgm-remote-monitor:latest_dev` or choose an older version like `cgm-remote-monitor:14.2.6`
+
+```
+sudo docker compose down
+sudo docker compose pull
+nohup sudo docker compose up -d &
+```
+
+</br>
+
 ## Deploy multiple instances
 
 Hints from [justmara](https://github.com/justmara)