Guidelines for Setting Up OpenEMR on Debian 12 Using NGINX
### Step-by-Step Installation of OpenEMR on Debian 12 with NGINX
OpenEMR is a full-featured, ONC-certified electronic health records (EHR) and medical practice management software. In this guide, we will walk through the process of installing OpenEMR on Debian 12, using NGINX as the web server.
#### Prerequisites:
- A Debian 12 server with sudo privileges - Internet access - Basic knowledge of Linux command line
#### 1. Update Your System
```bash sudo apt update sudo apt upgrade -y ```
#### 2. Install Required Packages: NGINX, PHP, and MariaDB
OpenEMR requires a web server, PHP with certain extensions, and a database server. Install the necessary packages:
```bash sudo apt install nginx mariadb-server mariadb-client php-fpm php-mysql php-xml php-gd php-curl php-mbstring php-zip php-bcmath php-imap unzip wget -y ```
#### 3. Secure MariaDB Installation
Run the secure installation script to improve MariaDB security:
```bash sudo mysql_secure_installation ```
Follow the prompts to set root password and remove anonymous users.
#### 4. Create OpenEMR Database and User
Log into MariaDB:
```bash sudo mariadb -u root -p ```
Inside MariaDB shell, execute:
```sql CREATE DATABASE openemr CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'openemruser'@'localhost' IDENTIFIED BY 'strong_password_here'; GRANT ALL PRIVILEGES ON openemr.* TO 'openemruser'@'localhost'; FLUSH PRIVILEGES; EXIT; ```
Replace `'strong_password_here'` with a secure password.
#### 5. Download and Extract OpenEMR
Navigate to the web root (e.g., `/var/www/html`):
```bash cd /var/www/html sudo wget https://github.com/openemr/openemr/releases/download/v7.0.1/openemr-7.0.1.zip sudo unzip openemr-7.0.1.zip -d openemr sudo chown -R www-data:www-data openemr ```
(Replace the version with the latest stable release if needed.)
#### 6. Configure PHP for OpenEMR
Edit PHP configuration for `php-fpm` (e.g., `/etc/php/8.1/fpm/php.ini` or your installed PHP version):
Ensure these settings:
``` date.timezone = Your/Timezone upload_max_filesize = 20M post_max_size = 20M memory_limit = 256M ```
After editing, restart PHP-FPM:
```bash sudo systemctl restart php8.1-fpm ```
#### 7. Configure NGINX for OpenEMR
Create a new NGINX site config `/etc/nginx/sites-available/openemr` with the following content:
```nginx server { listen 80; server_name your_domain_or_ip;
root /var/www/html/openemr; index index.php index.html index.htm;
access_log /var/log/nginx/openemr.access.log; error_log /var/log/nginx/openemr.error.log;
location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php8.1-fpm.sock; }
location ~ /\.(?!well-known).* { deny all; } } ```
Enable the site and reload NGINX:
```bash sudo ln -s /etc/nginx/sites-available/openemr /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx ```
#### 8. Complete Installation via Web Browser
Open your browser and navigate to:
``` http://your_domain_or_ip ```
The OpenEMR setup wizard should appear. Follow the prompts to:
- Verify server environment - Enter database credentials (`openemruser` and password) - Configure OpenEMR admin user and other settings
After completion:
- Delete or rename the `setup.php` file in `/var/www/html/openemr` for security.
```bash sudo rm /var/www/html/openemr/setup.php ```
#### 9. Adjust Firewall (if applicable)
If you have a firewall, allow HTTP traffic:
```bash sudo ufw allow 'Nginx Full' ```
This process covers the full installation of OpenEMR on Debian 12 using NGINX as a web server. The PHP version and paths may vary depending on your system. Always refer to OpenEMR official documentation for specific version compatibility.
Upon successful installation, the user is redirected to the OpenEMR login page. If successful, the user sees the OpenEMR dashboard after logging in with the admin user and password.
After creating the instance, locate the IP address of your instance and connect via SSH using PuTTY on Windows.
For additional assistance, such as configuring SSL certificates, optimizing performance, or troubleshooting common issues, feel free to ask.
Running OpenEMR on Debian 12 with NGINX provides a reliable, secure, and high-performance platform for clinics, hospitals, or healthcare startups. The installer creates the admin user for OpenEMR during the database initialization process.
Built-in audit logs, user access control, and encryption support are available in OpenEMR, making it suitable for HIPAA and GDPR compliance. OpenEMR also supports scheduling, e-prescriptions, billing, patient demographics, document storage, and clinical decision support.
- The installation of OpenEMR on Debian 12 uses various technologies, including NGINX as the web server, PHP for the application's functionality, and MariaDB for the database management system.
- OpenEMR, being a comprehensive electronic health records (EHR) system, offers advanced features such as scheduling, e-prescriptions, billing, patient demographics, and document storage, all leveraging modern technologies.
