Przejdź do treści

Zanim zaczniesz

Nightscout na Mikr.us

Ważne!

ZANIM COKOLWIEK ZACZNIESZ ROBIĆ - PRZECZYTAJ/OBEJRZYJ NAJPIERW CAŁOŚĆ,
JEŚLI BĘDZIE TRZEBA NAWET DWA LUB TRZY RAZY

Disclaimer

Nie testować na ludziach!

Wspomniane technologie nie powinny być używane do terapii, to nie jest porada medyczna, zawsze konsultuj się z lekarzem i zespołem terapeutycznym.

Moim skromnym zdaniem...

Wyrażone opinie należą wyłącznie do autora i nie są oficjalnym stanowiskiem grupy Technologie Diabetyka, wymienionych projektów open source, dostawców usług czy firm trzecich. Znaki i nazwy towarowe zostały użyte wyłącznie w celach edukacyjnych.

O czym JEST ten tutorial

Ten tutorial opisuje jak zainstalować system Nightscout na serwerze Mikr.us.

Nightscout to darmowy serwer (strona) www zbierający oraz prezentujący dane o glikemii i inne ważne parametry terapii diabetologicznej - w cukrzycy typu I. Dzięki Nightscout możemy łatwo udostępniać i analizować naszą glikemię. Nightscout spina także wiele aplikacji z ekosystemu narzędzi cukrzycowych - na przykład:

  • aplikację pacjenta z aplikacjami opiekunów w przypadku pętli AndroidAPS
  • tarcze do zegarków i opasek fitness które wyświetlają cukry
  • narzędzia do analizowania i generowania raportów dla lekarzy

Mikr.us to polski hobbystyczny serwer VPS. Serwer VPS to inaczej "Wirtualny Prywatny Serwer", wycinek pełnego serwera w chmurze, w przypadku Mikr.us-a jest to wycinek serwera Hetzner, zlokalizowany w Finlandii. Mikr.us dokłada do tego kilka usług i prostych narzędzi, m.in. subdomeny, API, panel administracyjny a w nim dostęp do serwera z poziomu www (WebSSH) oraz wsparcie adminów i pasjonatów (poprzez Facebook).

Dzięki współdzieleniu zasobów i zastosowaniu kilku ograniczeń (pamięci, miejsca na dysku, zasobów procesora, braku adresu IPv4) - całość usługi jest bardzo tania (jak na serwery VPS), rzędu 75zł NA ROK w konfiguracji Mikr.us 2.1 - wiele konkurencyjnych rozwiązań kosztuje tyle na miesiąc!

Szczęśliwie, ten niewielki tani serwer jest wystarczający dla naszych potrzeb - hostowania serwera Nightscout w na zewnętrznym serwerze, a w wariancie 2.1 jest wystarczająco silny aby udźwignąć kontenery Dokera z Nightscoutem i bazą danych. W tej opcji mamy 1GB RAM-u, 10GB przestrzeni dyskowej i łącze 1Gbps.

O czym NIE JEST ten tutorial

Ten tutorial NIE JEST o tym:

  • czym jest Nightscout lub pętla Android APS
  • jak skonfigurować Nightscout dla konkretnych potrzeb
  • jak podłączać urządzenia do Nightscout
  • jak instalować Nightscout w innych chmurach, innych serwerach czy na Raspberry Pi

Szkolenia i tutoriale

Ten tutorial jest momentami dość techniczny, pomyślany jako dokumentacja narzędzia.

Jeśli jesteś laikiem przewodniki i webinary na grupie Technologie Diabetyka mogą być dla Ciebie bardziej przystępne. Tomek przygotował Przewodnik z instalacji tego narzędzia

Jakie mam opcje, co muszę umieć i wiedzieć

Na stronie Nightscout opisywane są różne opcje jeśli chodzi o możliwość zainstalowania / uzyskania własnego serwera:

  • hostowanie własne, lokalnie
  • hostowanie własne na zdalnym serwerze lub w chmurze
  • użycie zewnętrznych serwisów robiących to za Ciebie

Każda z tych opcji ma wady i zalety:

  • kontrola i zależność od innych
  • aspekty prawne
  • koszt
  • ilość czasu jaki trzeba na to przeznaczyć
  • niezbędna sprawność techniczna i wiedza

Instalacja na Mikr.us-ie 2.1 to wariant gdzie sami instalujemy Nightscout na zdalnym, zarządzanym serwerze, sami konfigurujemy Nightscout, sami dbamy o serwer (bezpieczeństwo, aktualność pakietów, kopie zapasowe) - ale jego bazowe oprogramowanie i wszystkie tematy sieciowo/chmurowe/domenowe organizowane są przez dostawcę serwera.

Instalacja i konfiguracja Nightscout jest relatywnie prosta - odbywa się z użyciem narzędzia konsolowego przygotowanego przez autora tego poradnika.

Co musisz wiedzieć / potrafić

  • kupić i opłacić usługę on-line
  • znaleźć dane dostępowe serwera w mailu (po zakupie) i użyć ich do zalogowania się do panelu administracyjnego serwera
  • przeklejać konfigurację z przykładu
  • podmienić niektóre parametry konfiguracji (przykładowe) na własne - specyficzne dla Twojego przypadku
  • sprawnie kopiować Ctrl+C i wklejać Ctrl+V przykładowe komendy, czasami je edytując
  • czytać ze zrozumieniem i utrzymać skupienie

Do każdego z tych przypadków, jeśli okażą się potrzebne - podamy szczegóły i pokażemy na zrzutach ekranu jak to zrobić

Co musisz mieć

  • 💻 komputer klasy PC (Windows, MacOS lub Linux) z dostępem do internetu z zainstalowaną przeglądarką internetową

Zalecamy użyć Chrome, ale prawdopodobnie aktualny Chromium, Firefox, Opera lub Safari też dadzą radę. Odradzamy Internet Explorera i Edge.

  • ⏰ trochę czasu i spokoju - najlepiej zaczynać w sobotę rano i bez presji że system musi już działać “na wczoraj”
  • ☕ kawę, cierpliwość i pozytywne nastawienie - to nie takie trudne i na pewno się uda!

Mikr.us - kiedy warto, a kiedy nie

Warto kiedy:

  • Ogarniasz technicznie lub ktoś bliski kto jest zawsze na miejscu ogarnia
  • Chcesz mieć pewność że tylko ty masz dostęp do swoich danych i tylko ty kontrolujesz Nightscout
  • Masz niestabilny internet w domu lub hostowanie Nightscouta lokalnie jest poza Twoim zasięgiem
  • Chcesz mieć Nightscouta na zewnętrznym serwerze ale inne opcje są za drogie lub zbyt skomplikowane
  • Nie chcesz podawać danych karty kredytowej na zagranicznych stronach

Nie warto kiedy:

  • Instalujesz to dla kogoś lub ktoś znajomy chce Ci to zainstalować u Ciebie
  • Nie ogarniasz technicznie, nie lubisz grzebać

Legenda i konwencje

W tym tutorialu będziemy stosować kilka konwencji aby oznaczyć akcje - lub miejsca na zrzutach ekranu - na które należy zwrócić uwagę:

  • 👣 - krok do wykonania, akcja
  • 🗒 - ważna informacja/ustawienie/wartość/hasło do zapisania - będzie potrzebne niedługo
  • ✏ - tu wymagana będzie modyfikacja wartości - edytowanie aby dostosować ustawienie/tekst do Twoich specyficznych potrzeb, ustawień, sytuacji. Najlepiej wtedy przykład przekleić najpierw do jakiegoś porządnego edytora tekstu. Ale nie Word-a 🤦‍♂️ tylko takiego który jest przyjazny programistom, takie jak darmowe: Notepad++ lub Visual Studio Code i w tym edytorze popodmieniać wartości - przed przeklejeniem ich dalej.
  • 🟦 🟩 🟧 🟪 🟫 - kolorowe odnośniki w tekście odnoszą się do zaokrąglonych ramek/zaznaczeń w tym samym kolorze na zrzucie ekranu
  • ⬜ - "wyszarzone" obszary na zrzutach ekranu to cenzura aby ukryć nieistotne fragmenty (i ukryć szczegóły konfiguracji autora)
  • 🔍 - aby powiększyć ilustracje, zrzuty ekranu kliknij na ich środku
  • - w niektórych przykładach ta ikonka pozwala, po kliknięciu, od razu skopiować cały przykład do schowka. Ale uwaga - przeczytaj dokładnie czy nie trzeba tej wartości najpierw ✏ dostosować!

Autorzy

  • Autorem tego tutorialu i narzędzia do konfiguracji Mikr.us-a jest Dominik Dzienia
  • Tomek "Słodka Olga" udoskonalił wstępną konfigurację a dzięki jego bezcennym uwagom i pomysłom narzędzie jest jeszcze prostsze w użyciu, a społeczność ma dostęp do przewodników i webinarów z instalacji. Tomek także przekonał do idei Nightscout twórców serwerów mikr.us-a.
  • Review, korekty i cennych wskazówek udzielili członkowie i administratorzy grupy Technologie Diabetyka, oraz Małgorzata Dzienia
  • Twórcy Mikr.us-a (UW-Team) poświęcili wiele godzin pracy i specjalnie dla nas przygotowali dedykowany obraz systemu, podpięcie domeny oraz nowe API - dzięki którym instalacja jest jeszcze łatwiejsza!

Znalazłeś błąd lub masz sugestię odnośnie tutorialu...

Jeśli znalazłeś literówkę, błąd merytoryczny lub masz pomysł jak poprawić ten tutorial napisz bezpośrednio do autora na Messengerze lub wyślij maila

Masz pytania odnośnie Twojej instalacji...

Co do zasady, nie pomagamy w wiadomościach prywatnych - chcemy aby Twój problem i jego rozwiązanie pomógł innym użytkownikom. Dlatego zachęcamy aby najpierw kontaktować się z nami na grupie Technologie Diabetyka - używając lupki i szukając podobnych pytań lub tworząc post z opisem problemu.

Historia zmian

2023-10-15
  • sekcja z rozwiązywaniem problemów
2023-10-05
  • drobne poprawki
  • informacja o edycji ustawień i logowaniu z Google
2023-10-04
  • rozdział dla zaawansowanych
2023-10-02
  • uproszczona instalacja
2023-09-05
  • pierwsza wersja instrukcji

Build Status


Ostatnia aktualizacja: 2023-10-16