Comment installer OpenEMR sur le serveur Ubuntu 24.04

OpenEMR est une solution de gestion des dossiers de santé et de pratique médicale open-source. C’est un dossier de santé électronique entièrement intégré et une gestion de pratique, de planification, de facturation électronique et de support à l’internationalisation. OpenEMR est certifié par l’ONC, ce qui signifie qu’OpenEMR respecte les normes du Bureau du Coordinateur National pour la Technologie de l’Information sur la Santé (ONC).

Ce guide vous montrera comment installer OpenEMR sur le serveur Ubuntu 24.04 avec la pile LEMP (Linux, Nginx, MariaDB et PHP-FPM). Nous vous montrerons également comment sécuriser OpenEMR avec HTTPS de Let’s Encrypt et ouvrir les ports HTTP et HTTPS via UFW (Uncomplicated Firewall).

Prérequis

Pour commencer avec ce guide, assurez-vous d’avoir :

Un serveur Ubuntu 24.04
Un utilisateur non-root avec des privilèges d’administrateur
Un nom de domaine pointant vers l’adresse IP du serveur

Installation des dépendances LEMP

OpenEMR est une application web écrite en PHP et MySQL. Pour l’installer, vous devez vous assurer que PHP et MySQL sont installés. Dans ce guide, vous exécuterez OpenEMR avec la pile LEMP (Linux, Nginx, MariaDB et PHP). Donc pour l’instant, vous allez installer ces paquets via le dépôt APT.

Pour commencer, exécutez la commande ‘ apt ‘ ci-dessous pour mettre à jour votre index de paquets Ubuntu et installer les paquets de la pile LEMP (Linux, Nginx, MariaDB et PHP-FPM). Entrez ‘Y’ pour confirmer l’installation.

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

Après l’installation, vérifiez l’état du service ‘ nginx ‘ avec la commande ‘systemctl’ ci-dessous. Assurez-vous que Nginx est en cours d’exécution et activé.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

check nginx

Vérifiez maintenant le service ‘ mariadb ‘ en utilisant la commande suivante. Vous verrez que le serveur MariaDB est en cours d’exécution et activé sur votre serveur Ubuntu.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

Enfin, vérifiez le service ‘ php8.3-fpm ‘ avec la commande ci-dessous. Vous verrez que le service PHP-FPM est opérationnel.

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

check php-fpm

Configuration de PHP-FPM

Une fois la pile LEMP installée, configurons l’installation de PHP-FPM en modifiant le ‘php.ini’, puis en redémarrant le service PHP-FPM et en appliquant vos modifications.

Modifiez le fichier ‘ php.ini ‘ avec l’éditeur ‘ nano ‘.

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

Changez la configuration par défaut avec ce qui suit. Assurez-vous d’ajuster le ‘ memory_limit ‘ avec votre RAM actuelle.

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

Enregistrez le fichier et quittez l’éditeur une fois terminé.

Ensuite, exécutez la commande ‘chgrp’ ci-dessous pour changer la propriété du répertoire ‘ /var/lib/php/sessions ‘ à l’utilisateur ‘ www-data ‘.

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

Enfin, redémarrez le service ‘ php8.3-fpm ‘ avec la commande ci-dessous. Cela appliquera vos modifications à votre installation PHP-FPM.

sudo systemctl restart php8.3-fpm

Configuration du serveur MariaDB

Maintenant que PHP est configuré, configurons le serveur MariaDB et créons une nouvelle base de données pour OpenEMR. Dans cette section, vous sécuriserez le serveur MariaDB avec l’utilitaire ‘ mariadb-secure-installation ‘ et créerez une nouvelle base de données et un utilisateur via le client ‘ mariadb ‘.

Tout d’abord, exécutez la commande ‘ mariadb-secure-installation ‘ ci-dessous pour sécuriser votre serveur MariaDB.

sudo mariadb-secure-installation

Vous serez maintenant interrogé sur les configurations suivantes :

Appuyez sur ENTRER pour continuer et configurer le serveur MariaDB
Entrez ‘ Y ‘ pour configurer le mot de passe root de MariaDB, puis tapez et répétez votre mot de passe
Entrez ‘ Y ‘ pour désactiver la connexion à distance pour l’utilisateur ‘ root ‘
Entrez ‘ Y ‘ pour supprimer la base de données ‘ test ‘ et ses privilèges
Entrez ‘ Y ‘ pour terminer la configuration

Après que le serveur MariaDB soit sécurisé, vous devez créer une nouvelle base de données et un utilisateur qui seront utilisés par l’installation d’OpenEMR.

Connectez-vous au serveur MariaDB avec la commande ‘ mariadb ‘ ci-dessous. Entrez votre mot de passe root MariaDB lorsqu’on vous le demande.

sudo mariadb -u root -p

Exécutez les requêtes suivantes pour créer une nouvelle base de données et un utilisateur pour OpenEMR. Dans cet exemple, vous allez créer une nouvelle base de données ‘ openemr ‘ avec l’utilisateur ‘ openemruser ‘ et le mot de passe est ‘ password ‘. Vous pouvez ajuster les détails de la base de données avec vos informations.

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

Exécutez maintenant la requête ci-dessous pour vérifier les privilèges de l’utilisateur ‘openemruser’. Assurez-vous que l’utilisateur peut accéder à la base de données ‘openemr’.

SHOW GRANTS FOR openemruser@localhost;

Enfin, tapez ‘ quit ‘ pour quitter le serveur MariaDB.

show user privileges

Téléchargement du code source d’OpenEMR

Maintenant que vous avez configuré PHP-FPM et le serveur MariaDB, l’étape suivante consiste à télécharger le code source d’OpenEMR et à configurer l’installation avec les permissions et la propriété appropriées.

Allez dans le répertoire ‘ /var/www ‘ et téléchargez le code source d’OpenEMR en utilisant la commande ‘ wget ‘ ci-dessous.

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

Une fois téléchargé, exécutez la commande ‘tar’ ci-dessous pour extraire le code source d’OpenEMR et renommer le nouveau répertoire en ‘ openemr ‘. Avec cela, le code source d’OpenEMR sera stocké dans le répertoire ‘ /var/www/openemr ‘.

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

Enfin, exécutez la commande ‘chown’ ci-dessous pour changer la propriété du répertoire ‘ /var/www/openemr ‘ à l’utilisateur ‘ www-data ‘.

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

Configuration du bloc serveur Nginx

Après avoir téléchargé le code source d’OpenEMR, vous allez créer un nouveau bloc serveur Nginx qui sera utilisé pour exécuter votre installation d’OpenEMR. Assurez-vous donc que vous avez votre nom de domaine prêt et pointé vers l’adresse IP du serveur.

Créez une nouvelle configuration de bloc serveur Nginx ‘ /etc/nginx/sites-available/openemr ‘ avec la commande de l’éditeur ‘ nano ‘ suivante.

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

Insérez la configuration et assurez-vous de changer l’option ‘ server_name ‘ avec votre nom de domaine.

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;  
}  
  
# Passer les scripts PHP au serveur FastCGI  
location ~* \.php$ {  
try_files $uri =404;  
fastcgi_index index.php;  
fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Dépend de la version PHP  
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;  
fastcgi_param DOCUMENT_ROOT $realpath_root;  
include fastcgi_params;  
}  
  
# refuser l'accès aux fichiers/répertoires modifiables  
location ~* ^/sites/*/(documents|edi|era) {  
denied all;  
return 404;  
}  
  
# refuser l'accès à certains répertoires  
location ~* ^/(contrib|tests) {  
denied all;  
return 404;  
}  
  
# Alternativement, tout accès à ces fichiers peut être refusé  
location ~* ^/(admin|setup|acl_setup|acl_upgrade|sl_convert|sql_upgrade|gacl/setup|ippf_upgrade|sql_patch)\.php {  
denied all;  
return 404;  
}  
  
location = /favicon.ico {  
log_not_found off;  
access_log off;  
}  
  
location = /robots.txt {  
log_not_found off;  
access_log off;  
}  
  
location ~ /\. {  
denied all;  
}  
}

Enregistrez le fichier et quittez l’éditeur.

Exécutez maintenant la commande ci-dessous pour activer le bloc serveur ‘openemr’ et vérifier votre syntaxe Nginx. Si vous avez une syntaxe Nginx correcte, vous verrez une sortie telle que ‘ test réussi - la syntaxe est correcte ‘.

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

setup nginx

Enfin, exécutez la commande ‘ systemctl ‘ ci-dessous pour redémarrer le serveur web Nginx et appliquer vos modifications.

sudo systemctl restart nginx

Sécuriser OpenEMR avec HTTPS

Dans cette section, vous allez installer Certbot et sécuriser OpenEMR avec HTTPS. Cela fonctionnera si vous utilisez un nom de domaine public et un serveur. Sur un serveur local ou de développement, vous pouvez utiliser des certificats auto-signés.

Avant de configurer SSL, exécutez la commande ‘ufw’ ci-dessous pour ouvrir les services HTTP et HTTPS sur votre serveur. Vous verrez une sortie telle que ‘succès’.

Sudo ufw allow 'Nginx Full'

Installez maintenant le ‘ certbot ‘ et le plugin ‘ python3-certbot-nginx ‘ avec la commande ‘ apt ‘ suivante. Entrez ‘Y’ pour confirmer l’installation.

sudo apt install certbot python3-certbot-nginx -y

Après l’installation, exécutez la commande ‘certbot’ ci-dessous pour générer des certificats SSL et sécuriser votre installation OpenEMR.

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

Une fois le processus terminé, vos certificats SSL seront disponibles dans le répertoire ‘ /etc/letsencrypt/live/domain.com ‘. De plus, votre installation OpenEMR sera sécurisée avec HTTPS.

Installation d’OpenEMR

Ouvrez votre navigateur web et visitez https://openemr.howtoforge.local/ à travers un navigateur web.

Tout d’abord, l’installateur vérifiera les permissions du code source d’OpenEMR, alors assurez-vous d’avoir les permissions appropriées.

installation

Sélectionnez l’option ‘ J’ai créé la base de données ‘ pour configurer votre intégration de base de données.

i have the database

Entrez vos détails de base de données et le nouvel administrateur pour OpenEMR.

database settings

L’initialisation de la base de données sera en cours et votre utilisateur admin sera créé.

installation

Ensuite, assurez-vous que votre configuration PHP répond aux exigences d’OpenEMR.

php configuration

Une fois l’installation terminée, vous serez redirigé vers la page de connexion d’OpenEMR. Tapez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

Si cela réussit, vous verrez le tableau de bord OpenEMR suivant.

dashboard

Conclusion

Félicitations ! Vous avez terminé l’installation d’OpenEMR sur le serveur Ubuntu 24.04. OpenEMR est opérationnel avec PHP-FPM, le serveur web Nginx et le serveur MariaDB. Vous avez également sécurisé OpenEMR avec HTTPS via Certbot et Let’s Encrypt.