Zanim zaczniesz
Ważne!
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.
To się może źle skończyć!
Tutorial służy do celów edukacyjnych, przedstawia przykład możliwości konfiguracji przygotowany przez autora - ale nie jest oficjalną instrukcją i nie powinien być tak traktowany. Tutorial może zawierać błędy lub istotne niedopowiedzenia oraz zakłada pewien poziom wiedzy fachowej i technicznej u odbiorcy. Autor nie bierze odpowiedzialności za konsekwencje naśladowania opisywanych procesów lub wyniki podążania za tym tutorialem - działasz na własne życzenie i ryzyko!
Małym drukiem...
O ile nie zaznaczono inaczej, wszelkie prawa autorskie do opisywanych materiałów należą do autora. Przed rozpowszechnianiem zapytaj autora o zgodę!
Moim skromnym zdaniem...
Wyrażone opinie należą wyłącznie do autora i nie są oficjalnym stanowiskiem grupy Technologie Diabetyka, wymienionych projektów open source czy producentów sprzętu. 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 urządzeniu NAS firmy Synology.
A jeśli nie mam Synology NAS?
Niektóre fragmenty tego poradnika pomogą również uruchomić Nightscout na innych urządzeniach NAS lub w chmurze, pod warunkiem że wykorzystują kontenery Docker i docker compose lub Portainera. Ale wtedy niektóre kroki (tworzenie folderów, otwieranie portów, reverse proxy, SSL) należy zrobić w inny, specyficzny dla wybranej platformy sposób - ale jest to poza tematem tego tutoriala.
Zobacz też do paragrafu poniżej - o dostępnych opcjach
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
Synology to firma specjalizująca się w urządzeniach typu NAS. NAS to popularne rozwiązanie które zazwyczaj służy do udostępniania w sieci lokalnej (domowej) plików, filmów, kopii zapasowej komputerów i telefonów. Ze względu na uniwersalność, sporą moc obliczeniową i dzięki możliwości instalowania oprogramowania - to przystępny i dostępny nawet dla laików domowy serwer, na którym można doinstalować własne aplikacje - takie jak Nightscout.
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 chmurze lub Raspberry Pi
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 w chmurze
- użycie zewnętrznych serwisów robiących to za Ciebie
Porównanie opcji hostowania
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 Synology NAS to wariant gdzie sami hostujemy serwer lokalnie, sami konfigurujemy Nightscout ale sam system (Synology DSM) i większość oprogramowania systemowego jest dostarczana przez firmę Synology lub inne projekty open source. Dodatkowo system Synology DSM udostępnia większość opcji z poziomu graficznych “okienek” - więc jest bardziej przystępny dla laików.
Co musisz wiedzieć / potrafić
- znaleźć Synology w sieci lokalnej i umieć się do niego zalogować, jako administrator
- zainstalować program na PC
- zainstalować program na serwerze z linii komend
- 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) w sieci lokalnej i 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.
- skonfigurowany i działający Synology NAS podpięty do sieci lokalnej i do internetu - model który wspiera technologię Docker, najlepiej na architekturze Intel
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!
Synology NAS - kiedy warto, a kiedy nie
Warto kiedy:
- Ogarniasz technicznie lub ktoś bliski kto jest zawsze na miejscu ogarnia
- Masz już Synology NAS lub i tak planujesz kupić bo potrzebujesz go do innych celów
Nie warto kiedy:
- Instalujesz to dla kogoś lub ktoś znajomy chce Ci to zainstalować u Ciebie
- Wydaje Ci się że w ten sposób zaoszczędzisz te 20-30zł na miesiąc
- Nie ogarniasz technicznie, nie lubisz grzebać
- Chcesz kupić Synology tylko po to
- Masz niestabilny lub słaby internet w domu
Legenda i konwencje
W tym tutorialu będziemy stosować kilka konwencji aby oznaczyć akcje - lub miejsca na screenshotach - 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 screenshocie
- "wyszarzone" obszary na screenshotach to cenzura aby ukryć nieistotne fragmenty (i ukryć szczegóły konfiguracji autora)
- aby powiększyć ilustracje, screenshoty 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 jest Dominik Dzienia
- Review, korekty i cennych wskazówek udzielili członkowie i administratorzy grupy Technologie Diabetyka, oraz Małgorzata Dzienia
- Szczególne podziękowania dla @Pablo Ńczyk za testy i poprawki!
- Podziękowania dla Mirka Wojtylaka za hint z konfiguracją bazy na Atlasie
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
- 2022-10-03
-
- dodano brakujące sudo w komendzie instalacyjnej Portainera,
- poprawiono adres startowy Portainera z https na http (dzięki @SłodkaOlga)
- 2022-10-07
-
- usunięto zbyt specyficzny adres w sekcji A ja wolę MongoDB w chmurze na Atlasie aby nie sugerować konkretnej maszyny ale znaleźć dokładny cluster w panelu AtlasDB (dzięki @SłodkaOlga)
- 2022-10-15
-
- dodano sekcję o procedurze aktualizacji Nightscout (dzięki @Peter van Rijt)
