Stawianie Nightscout – rozwiązanie darmowe

MENU DZIAŁU

Postawienie własnego Nightscouta to świetny krok, który daje ogromną swobodę w monitorowaniu glikemii. Konfiguracja przy użyciu GitHuba, bazy MongoDB Atlas oraz platformy Northflank to obecnie jedna z najpopularniejszych i najbardziej stabilnych ścieżek.

Oto kompletna instrukcja krok po kroku, jak to zrobić.

Zanim zaczniesz (Przygotowanie)

Zanim przejdziesz do właściwych kroków, upewnij się, że masz założone (lub załóż teraz) darmowe konta na trzech platformach:

1. GitHub (github.com)
2. MongoDB Atlas (mongodb.com/cloud/atlas)
3. Northflank (northflank.com) – Uwaga: Northflank może wymagać podpięcia karty płatniczej w celu weryfikacji konta, nawet jeśli korzystasz z darmowego planu (Developer Tier).

Krok 1: Kopiowanie (Fork) repozytorium na GitHubie

Najpierw musisz skopiować oficjalny kod Nightscouta na swoje konto.

1. Zaloguj się na swoje konto GitHub.
2. Wejdź na stronę oficjalnego repozytorium Nightscout: [https://github.com/nightscout/cgm-remote-monitor](https://github.com/nightscout/cgm-remote-monitor).
3. W prawym górnym rogu kliknij przycisk „Fork”.
4. W nowym oknie nic nie zmieniaj, po prostu kliknij zielony przycisk „Create fork”.
5. Po kilku sekundach kod znajdzie się na Twoim koncie.

Krok 2: Tworzenie bazy danych w MongoDB Atlas

Tu będą przechowywane wszystkie Twoje odczyty cukru.

1. Zaloguj się do MongoDB Atlas.
2. Zostaniesz poproszony o stworzenie klastra. Wybierz opcję Free (M0 Sandbox) i kliknij Create. (Zalecany dostawca to np. AWS, a region wybierz najbliższy Tobie, np. Frankfurt).
3. Konfiguracja bezpieczeństwa (Security Quickstart):
   • Username and Password: Wpisz nazwę użytkownika (np. user_ns) oraz hasło. Koniecznie zapisz to hasło – będzie Ci potrzebne w późniejszym kroku. Nie używaj w haśle znaków specjalnych jak @ czy :. Kliknij Create User.
   • IP Access List: Baza musi pozwalać na połączenie z zewnątrz. W sekcji „Where would you like to connect from?” wpisz adres IP 0.0.0.0/0 (co oznacza dostęp z każdego miejsca) i kliknij Add Entry.
4. Kliknij Finish and Close, a potem Go to Databases.
5. Obok Twojego klastra kliknij przycisk Connect.
6. Wybierz opcję Drivers (lub „Connect your application”).
7. Znajdź i skopiuj podany tam link (Connection String). Będzie wyglądał mniej więcej tak: mongodb+srv://user_ns:<password>@cluster0.abcde.mongodb.net/?retryWrites=true&w=majority
8. Wklej ten link do Notatnika na swoim komputerze i podmień słowo <password> (razem z nawiasami) na hasło, które stworzyłeś w punkcie 3. To Twój gotowy URI bazy danych.

Krok 3: Konfiguracja i uruchomienie na Northflank

Teraz połączymy kod z GitHub z bazą z MongoDB na serwerze Northflank.

1. Zaloguj się na Northflank.
2. Utwórz nowy projekt (przycisk Create new project). Nazwij go dowolnie, np. nightscout-projekt.
3. Wewnątrz projektu kliknij Create new -> Service.
4. W konfiguracji serwisu zaznacz poniższe opcje:
   • Service Type: Combined
   • Repository: Zaznacz GitHub. Prawdopodobnie będziesz musiał autoryzować połączenie między Northflank a Twoim kontem GitHub.
   • Po autoryzacji wybierz z listy repozytoriów swoje sforkowane repozytorium: TwojLogin/cgm-remote-monitor.
   • Branch: master
5. W sekcji Build Options:
   • Wybierz Dockerfile. Ścieżka powinna automatycznie ustawić się na /Dockerfile.
6. W sekcji Resources:
   • Wybierz darmowy plan (często oznaczony jako Micro lub Developer).
7. W sekcji Networking / Ports:
   • Upewnij się, że Port 1 jest ustawiony na 1337 (często jest to wykrywane automatycznie, ale warto sprawdzić) i że jest oznaczony jako Public.
8. Środowisko (Environment variables) – NAJWAŻNIEJSZY KROK: W sekcji „Environment” musisz dodać kilka zmiennych, które powiedzą Twojemu Nightscoutowi, jak ma działać i gdzie jest baza danych. Dodaj je jako pary „Klucz” (Key) i „Wartość” (Value):
   • MONGO_CONNECTION = wklej tutaj cały zaktualizowany link z Notatnika (ten z kroku 2).
   • API_SECRET = wymyśl bezpieczne hasło (minimum 12 znaków). Posłuży Ci ono do logowania się do ustawień Twojego Nightscouta.
   • DISPLAY_TIME = 24
   • TIME_FORMAT = 24
   • CUSTOM_TITLE = np. Cukry Jana (To będzie nazwa Twojej strony).
   • ENABLE = wklej poniższy ciąg wtyczek: careportal basal dbsize rawbg iob maker cob bwp cage iage sage boluscalc pushover treatmentnotify pump openaps
9. Kliknij przycisk Create Service na samym dole.

Krok 4: Uruchomienie i domena

Po kliknięciu „Create Service”, Northflank zacznie budować Twojego Nightscouta (proces „Building” i „Deploying”). Może to potrwać od 5 do 10 minut.

1. Poczekaj, aż status zmieni się z pomarańczowego kółka na zielone z napisem Running.
2. W panelu Twojego serwisu (po lewej stronie lub w zakładce z portami) znajdziesz sekcję Ports & DNS (lub po prostu Networking).
3. Tam będzie znajdował się link do Twojej publicznej aplikacji – darmowa subdomena wygenerowana przez Northflank (zazwyczaj kończąca się na .northflank.app).
4. Kliknij w ten link. Powinna otworzyć się czarna strona startowa Nightscouta z prośbą o skonfigurowanie profilu.

Zakończenie

Twoja strona już działa! Aby w pełni z niej korzystać:

1. Na swojej nowej stronie kliknij prawy górny róg (ikonkę ustawień).
2. Na dole strony znajdź pole API Secret. Wpisz tam hasło, które zdefiniowałeś w Kroku 3 jako API_SECRET i kliknij „Update”.
3. Otwórz „Profile Editor”, utwórz i zapisz profil z Twoją strefą czasową.
4. Twoja strona jest gotowa do odbierania danych z Twojej aplikacji na telefonie (np. xDrip+, CamAPS, czy Dexcom w połączeniu z odpowiednim mostem). W ustawieniach telefonu wpisujesz adres swojej nowej strony oraz API_SECRET.