Nocturne

Nocturne - a modern diabetes management platform Nocturne is a platform that collects data from your sensor and pump, then makes it available in one place - similar to Nightscout. You can use the cloud version (already available at diab.ninja) or install it yourself on your own server. Nocturne is fully compatible with Nightscout, so your existing apps (Loop, Trio, xDrip+, AndroidAPS) should work immediately after you change the address. What is Nocturne? Nocturne is a completely rewritten diabetes data management platform. Built with .NET, it offers the features you know from Nightscout in a newer, faster, and easier-to-maintain form. Key Nocturne features: Full Nightscout API compatibility - all Nightscout endpoints are supported natively, so apps such as Loop, Trio, xDrip+, and AndroidAPS can send and retrieve data without any modifications. Built-in connectors for popular platforms - Dexcom, LibreLinkUp, Glooko, MiniMed CareLink, MyFitnessPal, Nightscout, and others. You do not need additional bridges or plugins. Modern authentication - instead of relying only on API_SECRET (a secret key), you can use OIDC login (for example, Google; in our case, we log in with a https://diab.ninja user account) and passkeys (hardware or biometric keys). Notifications and reports - Discord bot integration, advanced statistics (Time in Range, GRI), and print-ready reports. You can use Nocturne in two ways: Diab.ninja - a ready-to-use hosted service. You pay 45 PLN/13 USD per year ( pricing), choose a subdomain (for example, twoja-nazwa.diab.ninja ), and configure everything in your browser. Self-hosted - install Nocturne on your own server or computer. It is free and open source, but it requires basic technical knowledge of Docker and the terminal. What do you need? For Nocturne hosted on diab.ninja A web browser. An email address Access to data from your sensor or pump (for example, a Dexcom or LibreLinkUp account) For the self-hosted version A server or computer with Docker and Docker Compose installed. Optional: .NET 10 SDK, Node.js 24+, and pnpm 9+ if you want to build the project from source. Access to a terminal (command line). If you are not comfortable configuring a server, use Nocturne on diab.ninja. It is the more practical choice and will save you time and technical trouble. Step-by-step setup Option A: Nocturne on diab.ninja Go to https://diab.ninja and purchase Nightscout (in the User Panel, we provide options to convert and migrate from Nightscout to Nocturne) Enter your email address and complete registration. You will receive a message with an account activation link. After logging in to the User Panel, go to Instances and join the program by selecting "join Nocturne beta" Wait for an email confirming that your account has been added to the program In the instance menu, create a new Nocturne (beta) environment After a short while, your site will be available - simply click it. You may need to log in to the User Panel again, as this is how Nocturne authentication works If login is required, choose diab.ninja (Sign in with diab.ninja) After logging in, you will be taken to a panel where you can select your platforms (Dexcom, Libre, Medtronic, Tidepool, Glooko, etc.). Enter your login details for those services, and Nocturne will start retrieving the data automatically. Configure your apps. Open the app you use every day (Loop, Trio, xDrip+, AndroidAPS). In the Nightscout settings, enter the new URL, for example https://moja-cukrzyca.nocturne.run . If the app previously required API_SECRET, leave it blank or use a token generated in Nocturne. Nocturne no longer uses API_SECRET in its traditional form. It uses JWT tokens or OIDC login instead. Check your app's documentation to confirm whether it supports the new authentication method. Option B: Self-hosted (Docker Compose) Download the configuration files. Go to the Nocturne releases page on GitHub and download two files: docker-compose.yaml and .env.example . Prepare the .env file Copy .env.example to .env : bash cp .env.example .env Then open .env in a text editor and complete the following fields: BASE_DOMAIN - the domain where Nocturne will run (for example, moja-domena.pl ). POSTGRES_PASSWORD - the database password. INSTANCE_KEY - a long, random string (treat it like a root password). bash # Przykładowe wpisy w .env BASE_DOMAIN=moja-domena.pl POSTGRES_PASSWORD=twoje_tajne_haslo INSTANCE_KEY=twoj_dlugi_losowy_klucz BASE_DOMAIN is the address where your instance will be available. INSTANCE_KEY is the most important administrative key - never share it with anyone. Start Nocturne In the terminal, from the directory containing docker-compose.yaml , run: bash docker compose up -d Docker will download the images and start all required services (database, API, and web interface). Complete setup in your browser Open https://twoja-domena.pl in your browser (according to BASE_DOMAIN ). The setup wizard will appear. C