nightscout-docker

Comprehensive Docker Setup for Nightscout CGM Monitor on Raspberry Pi 4 or any Linux Computer/Server

Credit

I have gotten both the Dockerfile and the docker-compose.yml from liske/cgm-remote-monitor-docker, thank you!

Backstory

My girlfriend is a type 1 diabetic and so I got into CGM Monitoring. I wanted to create a guide of how I host my own Nightscout server under my own domain. It is very easy for everybody that owns a Linux Server (for example a Raspberry Pi 4). I will first explain how to setup Nightscout and later also how to setup Nginx so you can host Nightscout securely. If you don't own a domain you can use a free one (google is your friend). If you have any questions feel free to just write an e-mail to florian@schickel.me and I can try my best to help you.

Requirements for this to work

Any sort of Linux Computer/Server, have tested it both on ARM processors and AMD processors
Docker and Docker-Compose installed (google it if you don't know how to do that)
Administrative access to your router

Setup Nightscout

I have included the Dockerfile that I used, but it is for reference only

First Clone this repository to your server and go into the folder

git clone https://github.com/pyrmon/nightscout-docker.git && cd nightscout-docker

Edit the docker-compose-amd.yml file
- Change the API_SECRET value to a password with the min length of 12, I don't know if all special characters are okay
- Change the BASE_URL to the webadress you want to access Nightscout from later on
- If you don't use mg/dl then you can change DISPLAY_UNITS value to mmol
```
# admin secret
- API_SECRET=xxxxxxxxxxxx
# the URL to this Nightscout instance
- BASE_URL=https://ns.xxxxx.com
...
# use SI units by default
- DISPLAY_UNITS=mg/dl
```
This is it. Now follow this command and your Nightscout is running on the webadress http://localhost:1337/ if you run it on the same machine that you are accessing the web browser with or http://IPOFSERVER:1337/
```
docker-compose up -d
```

Setup Nginx

This will only be the explanation on how to get Nginx running
Just enter these commands and it will setup Nginx Proxy Mangager on http://localhost:81 / http://IPOFSERVER:1337/
```
cd nginx
docker-compose -f docker-compose-nginx.yml up -d
```
After this you can sign in as admin@example.com with the password changeme

Backup Nightscout

It makes sense to backup your mongo db in case that something crashes. For this reason I have included the backupNightscout.sh file
All you need to do is run this command:
```
./backupNightscout.sh
```
If you are running it for the first time you might need to give the shell file the right to be executed, if required you do this with:
```
chmod +x backupNightscout.sh
```
If you want this to run this on a specific schedule then I would recommend creating a cronjob for this
- A cronjob is a task that your linux machine executes on a specific schedule Cron
- To create a cronjob you need to execute crontab -e
- Then an entry like this need to be inserted 00 2 * * 0-6 /bin/bash /path/to/backupNightscout.sh
- This would execute the backup script every day at 2 am, make sure to put in your path to the backupNightscout.sh
- If you want to change the schedule you can lookup how to scheduling works here Crontab Guru
The backup will put the backup zips to ~/nightscout-backups/
To restore from a new mongodb you need to execute docker exec -d nightscout_mongo mongorestore /path/to/unzipped/restore-files
If you need help with a restore from the zip feel free to reach out

pyrmon / nightscout-docker