**Note: this is in an early testing phase and should be used with caution.
This project makes it relatively straightforward to deploy Nightscout CGM, on almost any platform, now that Heroku no longer offers a free tier. At the moment only AWS deployments have been completed, but Azure & GCP are expected in due time.
You can jump to the wiki for Guides on how to deploy Nightscout for yourself.
It's important to note that this is still fairly technical, but you can follow the instructions and end up with a working Nightscout site.
Taking the codified approach over the GUI (clicky) approach has some benefits:
- More straightforward for others to troubleshoot, because they can see exactly what's happening
- Quickly copy this repository as a template
- Quicky modify the templates for use with your flavour of, well, anything
- Most importantly it allows you to track any changes you make and revert more easily than clicking a button somewhere. By the same token you can upgrade with almost zero effort.
This project does not provide a free alternative to Heroku. Rather it takes the position that these files can be more easily run anywhere for very low cost.
Every iteration herein relies on a few key components:
- Nightscout (run via docker image)
- MongoDB (run via docker image)
- Caddy-Docker-Proxy
We use Caddy-Docker-Proxy to configure the reverse-proxy and automatically provision a TLS certificate for serving Nightscout over HTTPS.
There are two paths at the moment:
- The AWS path via Terraform
- The Docker Compose path
Note: If you're already familier with Terraform's Open Source CLI tool, you can probably just fork the repo and make any necessary changes.
This path is designed to be relatively low effort with a few basic steps and requirements. The high level steps are:
- Sign up for a GitHub account and fork this repository
- Sign up for an AWS account
- Retrieve your AWS credentials
- Use AWS to register a domain name
- Sign up for Terraform Cloud's free tier
- Use Terraform Cloud to tie it all together and push a button to get your nightscout
We've created (or are creating at the time of this commit) a guide you can follow here: https://github.com/pkolyvas/nightscout-as-code/wiki
The docker compose path puts the onus on you to configure and manage everything up to the host. You're responsible for domain hosting, networking, and the host intance. We're the kind of folks that find this stuff fun, but if you're unfamiliar with a lot of the tooling/software involved you may want to start with the AWS path via Terraform Cloud.
[TODO]
[TODO]
If you want to contribute here, that's fine. As for other forms of support, we highly recommend you support the Nightscout project, or other projects like LoopKit, more directly. Or simply join the Nightscout/We Are Not Waiting Discord and offer help to those who might need it.