So installieren Sie OpenEMR auf Ubuntu 24.04 Server

OpenEMR ist eine Open-Source-Lösung für Gesundheitsakten und das Management medizinischer Praxen. Es handelt sich um eine vollständig integrierte elektronische Gesundheitsakte und Praxisverwaltung, Terminplanung, elektronische Abrechnung und Unterstützung für Internationalisierung. OpenEMR ist ONC-zertifiziert, was bedeutet, dass OpenEMR die Standards des Büros des Nationalkoordinators für Gesundheitsinformationstechnologie (ONC) erfüllt.

Dieser Leitfaden zeigt Ihnen, wie Sie OpenEMR auf dem Ubuntu 24.04-Server mit dem LEMP-Stack (Linux, Nginx, MariaDB und PHP-FPM) installieren. Wir zeigen Ihnen auch, wie Sie OpenEMR mit HTTPS von Let’s Encrypt sichern und HTTP- sowie HTTPS-Ports über UFW (Uncomplicated Firewall) öffnen.

Voraussetzungen

Um mit diesem Leitfaden zu beginnen, stellen Sie sicher, dass Sie:

Einen Ubuntu 24.04-Server
Einen Nicht-Root-Benutzer mit Administratorrechten
Einen Domainnamen, der auf die IP-Adresse des Servers verweist

Installation der LEMP-Abhängigkeiten

OpenEMR ist eine webbasierte Anwendung, die in PHP und MySQL geschrieben ist. Um es zu installieren, müssen Sie sicherstellen, dass sowohl PHP als auch MySQL installiert sind. In diesem Leitfaden werden Sie OpenEMR mit dem LEMP-Stack (Linux, Nginx, MariaDB und PHP) ausführen. Daher installieren Sie vorerst diese Pakete über das APT-Repository.

Um zu beginnen, führen Sie den Befehl ‘ apt ‘ unten aus, um Ihr Ubuntu-Paket-Index zu aktualisieren und die LEMP-Stack-Pakete (Linux, Nginx, MariaDB und PHP-FPM) zu installieren. Geben Sie ‘Y’ ein, um die Installation zu bestätigen.

sudo apt update  
sudo apt install nginx mariadb-server php-fpm php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-soap imagemagick libtiff-tools php-ldap

install deps

Nachdem die Installation abgeschlossen ist, überprüfen Sie den Status des ‘ nginx ‘ Dienstes mit dem folgenden ‘systemctl’ Befehl. Stellen Sie sicher, dass Nginx läuft und aktiviert ist.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

check nginx

Überprüfen Sie nun den ‘ mariadb ‘ Dienst mit dem folgenden Befehl. Sie werden sehen, dass der MariaDB-Server auf Ihrem Ubuntu-Server läuft und aktiviert ist.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

Überprüfen Sie zuletzt den ‘ php8.3-fpm ‘ Dienst mit dem folgenden Befehl. Sie werden sehen, dass der PHP-FPM-Dienst aktiv ist.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

check php-fpm

Konfigurieren von PHP-FPM

Sobald der LEMP-Stack installiert ist, lassen Sie uns die PHP-FPM-Installation konfigurieren, indem wir die ‘php.ini’ bearbeiten, dann den PHP-FPM-Dienst neu starten und Ihre Änderungen anwenden.

Bearbeiten Sie die ‘ php.ini ‘ Datei mit dem ‘ nano ‘ Editor.

sudo nano /etc/php/8.3/fpm/php.ini

Ändern Sie die Standardkonfiguration wie folgt. Stellen Sie sicher, dass Sie das ‘ memory_limit ‘ mit Ihrem aktuellen RAM anpassen.

max_execution_time = 60  
max_input_time = -1  
memory_limit = 512M  
post_max_size = 30M  
upload_max_filesize = 30M  
max_input_vars = 3000  
mysqli.allow_local_infile = On

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie als Nächstes den ‘chgrp’ Befehl unten aus, um den Besitz des Verzeichnisses ‘ /var/lib/php/sessions ‘ auf den Benutzer ‘ www-data ‘ zu ändern.

sudo chgrp -R www-data /var/lib/php/sessions

Starten Sie zuletzt den ‘ php8.3-fpm ‘ Dienst mit dem folgenden Befehl neu. Dies wird Ihre Änderungen an Ihrer PHP-FPM-Installation anwenden.

sudo systemctl restart php8.3-fpm

Konfigurieren des MariaDB-Servers

Jetzt, da PHP konfiguriert ist, lassen Sie uns den MariaDB-Server konfigurieren und eine neue Datenbank für OpenEMR erstellen. In diesem Abschnitt sichern Sie den MariaDB-Server mit dem ‘ mariadb-secure-installation ‘ Dienstprogramm und erstellen eine neue Datenbank und einen Benutzer über den ‘ mariadb ‘ Client.

Führen Sie zuerst den Befehl ‘ mariadb-secure-installation ‘ unten aus, um Ihren MariaDB-Server zu sichern.

sudo mariadb-secure-installation

Jetzt werden Sie nach den folgenden Konfigurationen gefragt:

Drücken Sie ENTER, um fortzufahren und den MariaDB-Server zu konfigurieren
Geben Sie ‘ Y ‘ ein, um das MariaDB-Root-Passwort einzurichten, geben Sie dann Ihr Passwort ein und wiederholen Sie es
Geben Sie ‘ Y ‘ ein, um den Remote-Login für den Benutzer ‘ root ‘ zu deaktivieren
Geben Sie ‘ Y ‘ ein, um die Datenbank ‘ test ‘ und deren Berechtigungen zu löschen
Geben Sie ‘ Y ‘ ein, um die Konfiguration abzuschließen

Nachdem der MariaDB-Server gesichert ist, müssen Sie eine neue Datenbank und einen Benutzer erstellen, die von der OpenEMR-Installation verwendet werden.

Melden Sie sich mit dem folgenden Befehl beim MariaDB-Server an. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie die folgenden Abfragen aus, um eine neue Datenbank und einen Benutzer für OpenEMR zu erstellen. In diesem Beispiel erstellen Sie eine neue Datenbank ‘ openemr ‘ mit dem Benutzer ‘ openemruser ‘ und das Passwort ist ‘ password ‘. Sie können die Datenbankdetails mit Ihren Informationen anpassen.

CREATE DATABASE openemr;  
CREATE USER 'openemruser'@'localhost' IDENTIFIED BY 'Your_password2';  
GRANT ALL PRIVILEGES ON openemr.* TO 'openemruser'@'localhost';  
FLUSH PRIVILEGES;

create database and user

Führen Sie nun die folgende Abfrage aus, um die Berechtigungen für den ‘openemruser’ zu überprüfen. Stellen Sie sicher, dass der Benutzer auf die ‘openemr’ Datenbank zugreifen kann.

SHOW GRANTS FOR openemruser@localhost;

Geben Sie zuletzt ‘ quit ‘ ein, um den MariaDB-Server zu verlassen.

show user privileges

Herunterladen des OpenEMR-Quellcodes

Jetzt, da Sie PHP-FPM und den MariaDB-Server konfiguriert haben, besteht der nächste Schritt darin, den OpenEMR-Quellcode herunterzuladen und die Installation mit den richtigen Berechtigungen und Besitzverhältnissen einzurichten.

Gehen Sie zum Verzeichnis ‘ /var/www ‘ und laden Sie den OpenEMR-Quellcode mit dem folgenden ‘ wget ‘ Befehl herunter.

cd /var/www/  
wget https://sourceforge.net/projects/openemr/files/OpenEMR%20Current/7.0.2/openemr-7.0.2.tar.gz

Sobald der Download abgeschlossen ist, führen Sie den ‘tar’ Befehl unten aus, um den OpenEMR-Quellcode zu extrahieren und das neue Verzeichnis in ‘ openemr ‘ umzubenennen. Damit wird der OpenEMR-Quellcode im Verzeichnis ‘ /var/www/openemr ‘ gespeichert.

tar -pxzf openemr-7.0.2.tar.gz  
mv openemr-7.0.2 openemr

Führen Sie zuletzt den ‘chown’ Befehl unten aus, um den Besitz des Verzeichnisses ‘ /var/www/openemr ‘ auf den Benutzer ‘ www-data ‘ zu ändern.

sudo chown -R www-data:www-data /var/www/openemr

Einrichten des Nginx-Serverblocks

Nachdem Sie den OpenEMR-Quellcode heruntergeladen haben, erstellen Sie einen neuen Nginx-Serverblock, der für die Ausführung Ihrer OpenEMR-Installation verwendet wird. Stellen Sie sicher, dass Sie Ihren Domainnamen bereit haben und auf die Server-IP-Adresse verweisen.

Erstellen Sie eine neue Nginx-Serverblockkonfiguration ‘ /etc/nginx/sites-available/openemr ‘ mit dem folgenden ‘ nano ‘ Editorbefehl.

sudo nano /etc/nginx/sites-available/openemr

Fügen Sie die Konfiguration ein und stellen Sie sicher, dass Sie die ‘ server_name ‘ Option mit Ihrem Domainnamen ändern.

server {  
listen 80;  
server_name openemr.example.com;  
  
access_log /var/log/nginx/openemr.access.log;  
error_log /var/log/nginx/openemr.error.log;  
  
root /var/www/openemr;  
  
index index.php;  
  
location / {  
try_files $uri $uri/ /index.php;  
}  
  
# PHP-Skripte an den FastCGI-Server weiterleiten  
location ~* \.php$ {  
try_files $uri =404;  
fastcgi_index index.php;  
fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Hängt von der PHP-Version ab  
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;  
fastcgi_param DOCUMENT_ROOT $realpath_root;  
include fastcgi_params;  
}  
  
# Zugriff auf beschreibbare Dateien/Verzeichnisse verweigern  
location ~* ^/sites/*/(documents|edi|era) {  
den all;  
return 404;  
}  
  
# Zugriff auf bestimmte Verzeichnisse verweigern  
location ~* ^/(contrib|tests) {  
den all;  
return 404;  
}  
  
# Alternativ kann der Zugriff auf diese Dateien verweigert werden  
location ~* ^/(admin|setup|acl_setup|acl_upgrade|sl_convert|sql_upgrade|gacl/setup|ippf_upgrade|sql_patch)\.php {  
den all;  
return 404;  
}  
  
location = /favicon.ico {  
log_not_found off;  
access_log off;  
}  
  
location = /robots.txt {  
log_not_found off;  
access_log off;  
}  
  
location ~ /\. {  
den all;  
}  
}

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun den Befehl unten aus, um den ‘openemr’ Serverblock zu aktivieren und Ihre Nginx-Syntax zu überprüfen. Wenn Sie korrekt sind und die richtige Nginx-Syntax haben, sehen Sie eine Ausgabe wie ‘ test ist erfolgreich - Syntax ist ok ‘.

sudo ln -s /etc/nginx/sites-available/openemr /etc/nginx/sites-enabled/  
sudo nginx -t

setup nginx

Führen Sie zuletzt den ‘ systemctl ‘ Befehl unten aus, um den Nginx-Webserver neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart nginx

Sichern von OpenEMR mit HTTPS

In diesem Abschnitt installieren Sie Certbot und sichern OpenEMR mit HTTPS. Dies funktioniert, wenn Sie einen öffentlichen Domainnamen und Server verwenden. Auf einem lokalen Server oder in der Entwicklung können Sie selbstsignierte Zertifikate verwenden.

Bevor Sie SSL einrichten, führen Sie den ‘ufw’ Befehl unten aus, um sowohl HTTP- als auch HTTPS-Dienste auf Ihrem Server zu öffnen. Sie werden eine Ausgabe wie ‘success’ sehen.

Sudo ufw allow 'Nginx Full'

Installieren Sie nun das ‘ certbot ‘ und das ‘ python3-certbot-nginx ‘ Plugin mit dem folgenden ‘ apt ‘ Befehl. Geben Sie ‘Y’ ein, um die Installation zu bestätigen.

sudo apt install certbot python3-certbot-nginx -y

Nachdem die Installation abgeschlossen ist, führen Sie den ‘certbot’ Befehl unten aus, um SSL-Zertifikate zu generieren und Ihre OpenEMR-Installation zu sichern.

sudo certbot --nginx -d openemr.howtoforge.local

Sobald der Prozess abgeschlossen ist, sind Ihre SSL-Zertifikate im Verzeichnis ‘ /etc/letsencrypt/live/domain.com ‘ verfügbar. Außerdem wird Ihre OpenEMR-Installation mit HTTPS gesichert.

Installation von OpenEMR

Öffnen Sie Ihren Webbrowser und besuchen Sie https://openemr.howtoforge.local/ über einen Webbrowser.

Zuerst überprüft der Installer die Berechtigungen des OpenEMR-Quellcodes, stellen Sie also sicher, dass Sie die richtigen Berechtigungen haben.

installation

Wählen Sie die Option ‘ Ich habe die Datenbank erstellt ‘, um Ihre Datenbankintegration einzurichten.

i have the database

Geben Sie Ihre Datenbankdetails und den neuen Administrator für OpenEMR ein.

database settings

Die Datenbankinitialisierung wird ausgeführt und Ihr Admin-Benutzer wird erstellt.

installation

Stellen Sie als Nächstes sicher, dass Ihre PHP-Konfiguration den Anforderungen von OpenEMR entspricht.

php configuration

Sobald die Installation abgeschlossen ist, werden Sie zur Anmeldeseite von OpenEMR weitergeleitet. Geben Sie Ihren Admin-Benutzernamen und Ihr Passwort ein und klicken Sie auf Anmelden.

Wenn erfolgreich, sehen Sie das folgende OpenEMR-Dashboard.

dashboard

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von OpenEMR auf dem Ubuntu 24.04-Server abgeschlossen. OpenEMR läuft mit PHP-FPM, Nginx-Webserver und MariaDB-Server. Sie haben OpenEMR auch mit HTTPS über Certbot und Let’s Encrypt gesichert.