{"id":951,"date":"2023-02-09T23:28:34","date_gmt":"2023-02-09T21:28:34","guid":{"rendered":"https:\/\/handbuch.alarmiator.de\/?post_type=docs&p=951"},"modified":"2025-01-30T23:07:36","modified_gmt":"2025-01-30T21:07:36","password":"","slug":"von-nativer-installation-zu-docker-compose-migrieren","status":"publish","type":"docs","link":"https:\/\/handbuch.alarmiator.de\/?docs=von-nativer-installation-zu-docker-compose-migrieren","title":{"rendered":"Von Nativer Installation zu Docker Compose migrieren"},"content":{"rendered":"\n

Eine Installation mit Docker Compose bringt f\u00fcr dich als Administrator einige Vorteile bez\u00fcglich des Installationsaufwands und des Aufwands den es ben\u00f6tigt den Server upzudaten. Deshalb empfehlen wir ein natives Setup zu Docker Compose zu migrieren. <\/p>\n\n\n\n

Im folgenden werden die n\u00f6tigen Schritte beschrieben die daf\u00fcr notwenig sind. <\/p>\n\n\n\n

Natives Setup Updaten<\/h2>\n\n\n\n

Um sp\u00e4ter dein Backup problemlos einzuspielen update zuerst deinen nativen Server. Starte diesen nach dem Update und f\u00fchre danach einen Neustart \u00fcber das Adminpanel aus, um den neuen Datenbankmodus zu starten, der mit dem neuen Release benutzt wird, um den Server zu beschleunigen. <\/p>\n\n\n\n

Docker installieren<\/h2>\n\n\n\n

Solltest du Docker noch nicht installiert haben kannst du im Guide zur Installation des Servers mit Docker Compose <\/a>nachschauen wie das geht. Relevant sind Schritte 1 bis einschlie\u00dflich 4. Folge nach dem Installieren von Docker wieder diesem Guide, um die Migration durchzuf\u00fchren. <\/p>\n\n\n\n

Backup anlegen<\/h2>\n\n\n\n

Diesen Schritt auf keinen Fall \u00fcberspringen<\/strong> wir ben\u00f6tigen das Backup danach, um es ins frische Compose Setup einzuspielen!<\/p>\n\n\n\n

Hast du kein Backup wirst du danach einen frischen Server haben.<\/p>\n\n\n\n

Ein Backup kannst du im Admin UI erstellen unter dem Reiter „Backup & Restore“. Lade es dir danach herunter und lege es irgendwo sicher ab. <\/p>\n\n\n\n

Neuer Ordner im Home Verzeichnis<\/h2>\n\n\n\n

Du solltest auf deinem Server einen Ordner „alarmiatorserver“ oder \u00e4hnliches eingerichtet haben, in dem alle Dateien f\u00fcr die Native Installation liegen. Wir empfehlen dir im Home Verzeichnis einen neuen Ordner anzulegen: <\/p>\n\n\n\n

cd ~ && mkdir alarmiator-server && cd alarmiator-server <\/code><\/pre>\n\n\n\n
Compose File erstellen<\/h2>\n\n\n\n
Nun wollen wir ein sogenanntes Compose File erstellen: <\/p>\n\n\n\n
nano docker-compose.yml<\/code><\/pre>\n\n\n\n
Kopiere folgenden Text in das File und speicher es ab:<\/p>\n\n\n\n
networks:\n  alarmiator-network:\n    name: alarmiator-network\n    driver: bridge\n\nservices:\n  alarmiator_service:\n    networks:\n      - alarmiator-network\n    restart: always\n    image: alarmiator\/alarmiator\n    healthcheck:\n      test: curl --fail http:\/\/localhost:5000 || exit 1\n      interval: 20s\n      retries: 5\n      start_period: 600s\n      timeout: 10s\n    volumes:\n      - alarm-db:\/alarmiatorserver\/store\n      - alarm-katsys-uploads:\/alarmiatorserver\/plugins\/inbound\/katsys\/uploads\n      - alarm-public-img:\/alarmiatorserver\/public\/assets\/img\n      - alarm-uploads:\/alarmiatorserver\/uploads\n      - alarm-logs:\/alarmiatorserver\/logs\n      - alarm-backups:\/alarmiatorserver\/backup\n  nginxProxyManager:\n    networks:\n      - alarmiator-network\n    image: 'jc21\/nginx-proxy-manager:2.10.0'\n    restart: always\n    depends_on:\n      alarmiator_service:\n        condition: service_healthy\n    ports:\n      - '80:80'\n      - '81:81'\n      - '443:443'\n    healthcheck:\n      test: curl --fail http:\/\/localhost:81 || exit 1\n      interval: 20s\n      retries: 5\n      start_period: 10s\n      timeout: 10s\n    volumes:\n      - \/nginx-pm\/data:\/data\n      - \/nginx-pm\/letsencrypt:\/etc\/letsencrypt\n\nvolumes:\n  alarm-db:\n  alarm-katsys-uploads:\n  alarm-public-img:\n  alarm-uploads:\n  alarm-logs:\n  alarm-backups:<\/code><\/pre>\n\n\n\n
Dieser Text sagt Docker wie er unseren Alarmiator Server zum laufen bringen soll. Das erspart uns jegliche weitere manuelle Installation.
Auch beim Update des Servers wird automatisch ein neues Release heruntergeladen und danach sofort gestartet.<\/p>\n\n\n\n
Beta Tester werden<\/h3>\n\n\n\n
Falls du bzw. deine Organisation schneller Neuerungen erhalten m\u00f6chte bieten wir eine Beta Version an. Diese wird hochgeladen, nachdem wir ein Release getestet haben und erlaubt es euch vor dem offiziellen Release diese Beta Versionen zu testen. Falls ihr dann Probleme entdeckt k\u00f6nnt ihr uns diese melden und wir k\u00f6nnen Sie vor dem offiziellen Release noch beheben. <\/p>\n\n\n\n
Um auf die Beta Version umzusteigen muss folgende Zeile in der docker-compose.yml ge\u00e4ndert werden:<\/p>\n\n\n\n
    image: alarmiator\/alarmiator<\/code><\/pre>\n\n\n\n
zu:<\/p>\n\n\n\n
    image: alarmiator\/alarmiator:latest-beta<\/code><\/pre>\n\n\n\n
Das Beta Image wird nicht automatisch geupdated. Das muss dennoch wie bei einem normalen Release manuell getan werden wie im n\u00e4chsten Abschnitt erkl\u00e4rt. Man kann sich jedoch mit einem Projekt namens Watchtower<\/a> selbst ein Monitoring einrichten, um Benachrichtigungen zu erhalten, wenn eine neue Beta Version hochgeladen wurde.<\/p>\n\n\n\n
Das neue Release (Docker Image) herunterladen<\/h2>\n\n\n\n
Um das Docker Image herunterzuladen gib folgendes ein: <\/p>\n\n\n\n
docker compose pull<\/code><\/pre>\n\n\n\n
Das l\u00e4dt erstmal das Image herunter und entpackt es. So k\u00f6nnen wir das neue Release herunterladen ohne den Nativen ALARMiator Server zu stoppen. Das erspart uns eine lange Downtime beim migrieren. <\/p>\n\n\n\n
Natives Setup stoppen<\/h2>\n\n\n\n
Bevor wir jedoch starten m\u00fcssen wir das alte Setup erstmal stoppen. <\/p>\n\n\n\n
Das Native Setup hat ja bereits Docker Images wie den Nginx Proxy Manager am laufen. Diesen wollen wir nun stoppen. 
Suchen wir einmal unseren Container: <\/p>\n\n\n\n
 docker ps --format \"{{.ID}}: {{.Image}}\"<\/code><\/pre>\n\n\n\n
Wir wollen den goaccess Container und den Nginx Proxy Manager stoppen. Du siehst in deiner Konsole nun jeweils links die ID des Containers und Rechts davon den Image Namen. Gebe also f\u00fcr diese beiden Container diesen Befehl nacheinander ein und ersetze jeweils die container_id:<\/p>\n\n\n\n
docker stop <container_id> && docker rm <container_id> -v<\/code><\/pre>\n\n\n\n
Gibst du jetzt wieder den „docker ps “ Befehl von oben ein solltest du keine laufenden Container mehr sehen, au\u00dfer den Portainer. Dieser darf bleiben. <\/p>\n\n\n\n
So nun wollen wir noch den eigentlichen nativen ALARMiator-Server stoppen. Navigiere dazu in den Ordner des nativen Setups:<\/p>\n\n\n\n
cd ..\/alarmiatorserver && ls<\/code><\/pre>\n\n\n\n
Du solltest nun alle Ordner und Dateien des letzten Releases sehen. Gebe hier folgendes ein: <\/p>\n\n\n\n
pm2 delete 0 <\/code><\/pre>\n\n\n\n
Das l\u00f6scht den alten Server aus der pm2 Startup Liste. <\/p>\n\n\n\n
Navigieren wir nun wieder in den Ordner f\u00fcr das neue Setup: <\/p>\n\n\n\n
cd ..\/alarmiator-server<\/code><\/pre>\n\n\n\n
Docker Compose Setup starten<\/h2>\n\n\n\n
Gebe folgendes ein, um eine frische Instanz hochzufahren: <\/p>\n\n\n\n
docker compose up -d<\/code><\/pre>\n\n\n\n
Sieht dein Terminal so aus l\u00e4uft bereits alles was du ben\u00f6tigst:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Als1 n\u00e4chstes wollen wir den Server von au\u00dfen \u00fcber einen Reverse Proxy erreichbar machen.<\/p>\n\n\n\n
Monitoring des Traffics<\/h2>\n\n\n\n
Solltest du Monitoring wollen k\u00f6nnen wir goaccess empfehlen. Dieser liest die Logs des Reverse Proxies aus und visualisiert Sie.
Hier sind jedoch sensible Daten zu sehen. Stelle also unbedingt sicher, dass dieses Dashboard nicht \u00f6ffentlich zu erreichen ist.
Hier ist eine yml Konfiguration die du als Service in die docker-compose.yml schreiben k\u00f6nntest:<\/p>\n\n\n\n
goaccess:\n    image: xavierh\/goaccess-for-nginxproxymanager:latest\n    container_name: goaccess\n    restart: always\n    depends_on:\n      nginxProxyManager:\n        condition: service_healthy\n    environment:\n        - TZ=Europe\/Berlin\n        - LOG_TYPE=NPM\n    ports:\n        - '7880:7880'\n    volumes:\n      - \/nginx-pm\/data\/logs:\/opt\/log:ro<\/code><\/pre>\n\n\n\n
Da der interne Port 7880 auf den Host gemapped wird ist dieser auf einer VPS sofort unverschl\u00fcsselt zu erreichen. Falls du dich nicht gut genug auskennst empfehlen wir dir kein Monitoring auf diese Weise einzurichten.<\/p>\n\n\n\n
SSL Zertifikate installieren<\/h2>\n\n\n\n
Voraussetzungen \u2013 Portweiterleitung<\/h3>\n\n\n\n
Damit die entsprechenden Zertifikate erstellt werden k\u00f6nnen, muss Dein ALARMiator Server \u00fcber den Port 80 und Port 443 aus dem Internet erreichbar sein. Die Zertifizierungsstelle baut w\u00e4hrend des Prozesses kurz eine Verbindung zu Deinem Server auf um sicher zu stellen, dass die Anfrage auch berechtig ist.<\/p>\n\n\n\n
Um Deinen ALARMiator Server \u00fcber Port 80 und Port 443 aus dem Internet erreichbar zu machen, musst Du in Deinem Router (der die Internetverbindung herstellt) und ggf. auch in Firewall-Systemen (solltest Du welche betreiben) eine Port-Weiterleitung einrichten. Da dies von Router zu Router unterschiedlich eingerichtet wird, k\u00f6nnen wir hier an dieser Stelle keine direkte Anleitung geben. Suche in der Oberfl\u00e4che Deines Router nach Begriffen wie \u201ePort-Forwarding, Port-Weiterleitung, etc.\u201c.<\/p>\n\n\n\n
Meist gibt man einen Quellport (das ist der aus dem Internet ankommende, hier Port 80 und Port 443), eine IP-Adresse des Zielsystems (in unserem Fall Dein ALARMiator Server) und einen Zielport an (in unserem Fall auch wiederum Port 80 und Port 443).<\/p>\n\n\n\n
SSL-Zertifikat anfordern<\/h3>\n\n\n\n
Verbinde dich in deinem Browser mit deinem NGINX Proxy Manager:<\/p>\n\n\n\n
```<ip-addresse>```:81<\/code><\/pre>\n\n\n\n
Standardlogin bei Erstanmeldung ist:<\/p>\n\n\n\n
Email:    admin@example.com\nPassword: changeme<\/code><\/pre>\n\n\n\n
Nach \u00c4nderung deiner Login Daten solltest du folgendes sehen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Klicke auf \u201eSSL Certificates\u201c dann auf \u201eAdd SSL Certificate\u201c:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Trage unter Domain Names deine Domain f\u00fcr deinen ALARMiator ein und dr\u00fccke Enter.<\/p>\n\n\n\n
Gebe nun noch eine Mail an, um dein SSL Zertifikat von Let\u2019s Encrypt anzufordern.<\/p>\n\n\n\n
Dr\u00fccke auf Save.<\/p>\n\n\n\n
Du hast nun dein SSL Zertifikat angefordert.<\/p>\n\n\n\n
Reverse Proxy einrichten<\/h2>\n\n\n\n
Als n\u00e4chstes wollen wir unseren Alarmiator Server ordentlich \u00fcber einen Reverse Proxy nach au\u00dfen zug\u00e4nglich machen.<\/p>\n\n\n\n
Navigiere zu \u201eProxy Hosts\u201c und klicke auf \u201eAdd Proxy Host\u201c.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Du solltest folgendes sehen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Hier m\u00fcssen wir nun eintragen wie unser Proxy auf den ALARMiator Server weiterleiten soll.<\/p>\n\n\n\n
WICHTIG: Es muss \u201ealarmiator_service\u201c als hostname angegeben sein. Dieser ist in unserer compose.yml so genannt worden und muss auch hier \u00fcbereinstimmen. Zus\u00e4tzlich darf der hostname von eurem Server nicht identisch sein. Habt ihr also euren Docker Host als ihr Linux installiert habt \u201ealarmiator_service\u201c genannt solltet ihr in der oben angegeben docker-compose-yml alle Vorkommnisse von alarmiator_service zu etwas anderem \u00e4ndern und logischer Weise auch im Nginx Proxy Manager diesen neuen Namen verwenden.<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ersetze hier nat\u00fcrlich die Domain Names mit deiner Domain. Den Rest kannst du 1:1 \u00fcbernehmen.<\/p>\n\n\n\n
Klicke nun auf den Custom Locations Tab. Klicke auf Add Location um eine neue Weiterleitung einzuf\u00fcgen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Beachte hier den extra Slash hinter alarmiator_service<\/strong>. Diesen ben\u00f6tigst du nur f\u00fcr die Api Location.<\/p>\n\n\n\n
Nun tragen wir noch zwei weiter Locations ein.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Das ist einmal die Weiterleitung f\u00fcr das Wallboard und als zweites die Weiterleitung f\u00fcr den Spaceport.<\/p>\n\n\n\n
W\u00e4hle nun noch dein Zertifikat im SSL Tab aus.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Force SSL und HSTS dienen zur Erh\u00f6hung der Sicherheit und sollten gesetzt sein.<\/p>\n\n\n\n
Das war\u2019s auch schon. Du solltest deinen ALARMiator Server jetzt SSL verschl\u00fcsselt \u00fcber deine Domain erreichen k\u00f6nnen!
Falls du das nicht kannst haben wir eine Docker Troubleshooting Guide. Dort ist beschreiben wie du zum Beispiel alle Container mit Log Ausgaben startest usw.<\/p>\n\n\n\n
Backup einspielen<\/h2>\n\n\n\n
Logge dich auf deiner frischen ALARMiator Instanz ein mit dem Standardlogin:<\/p>\n\n\n\n