One place for hosting & domains


      How To Install OpenEMR on Ubuntu 20.04 with a LAMP Stack (Apache, MySQL, PHP)


      OpenEMR is an open source electronic health records and medical practice management tool. It is used by physicians and healthcare facilities to manage electronic medical records, prescriptions, patient demographic tracking, scheduling, reports, and electronic billing. At the time of this publication, OpenEMR supports more than 30 languages.

      In this tutorial, you will install OpenEMR on an Ubuntu 20.04 server running a LAMP environment (Linux, Apache, MySQL, PHP).


      • An Ubuntu 20.04 server with a non-root sudo-enabled user account and a basic firewall. This can be configured using our initial server setup guide for Ubuntu 20.04.
      • A fully installed LAMP stack, including Apache, MySQL, and PHP, with firewall settings adjusted to allow HTTP traffic. Instructions for installing a LAMP stack can be found in Steps 1 through 3 in our guide How To Install Linux, Apache, MySQL, PHP (LAMP) stack on Ubuntu 20.04. Note that Steps 4 through 6 of the LAMP guide are optional as they are for testing purposes and unnecessary for this tutorial.

      Step 1 — Installing Additional PHP Extensions

      When setting up our LAMP stack, a minimal set of extensions were required to get PHP to communicate with MySQL. OpenEMR requires two additional PHP extensions that you will need to install for it to work correctly. Use apt to update your server’s package list and install the php-xml and php-mbstring extensions:

      • sudo apt update
      • sudo apt install php-xml php-mbstring

      After both extensions have been installed, you’ll need to reload the Apache web server for changes to take effect:

      • sudo systemctl reload apache2

      When your webserver has reloaded, you should be ready to proceed to the next step.

      Step 2 — Create a MySQL Database for OpenEMR

      You will now create a database in MySQL for OpenEMR. First, log in to MySQL as the database root user:

      Once you are logged into MySQL as the database root user, create a database named openemr with the following command:

      Next, create a new user and assign them a password by replacing PASSWORD below with a strong password of your choosing:

      • CREATE USER 'openemr_user'@'localhost' IDENTIFIED BY 'PASSWORD';

      Next, grant the new user permission to the openemr database:

      • GRANT ALL PRIVILEGES ON openemr.* TO 'openemr_user'@'localhost';

      To enable these changes, enter the following command:

      Once you have flushed the privileges, you can now exit MySQL:

      You are now ready to proceed to the next step.

      Step 3 — Configuring PHP for OpenEMR

      In this step, you’ll make some changes to the php.ini file as recommended by OpenEMR documentation. If you followed all prerequisites within a fresh Ubuntu 20.04 server, the php.ini that applies to your Apache web server should be located at /etc/php/7.4/apache2/php.ini. In case you have a different PHP version, this path may be slightly different. Adjust as necessary and open the file with a text editor of your choice. Here, we’ll use nano:

      • sudo nano /etc/php/7.4/apache2/php.ini

      Once you are in the php.ini file, you will change the values of several options as recommended by OpenEMR. If you are using nano, you can search for these options using CTRL + W. If there is a semicolon ; in front of the option you are adjusting, make sure to delete it as a semicolon is used to comment out an option.

      Values for the following options should be changed:

      max_ input_vars

      This option limits the number of variables your server can use in a single function. OpenEMR requires this option to have the value 3000:


      max_input_vars = 3000


      This option limits the amount of time (in seconds) a script is allowed to run before being terminated. OpenEMR requires this option to have the value 60:


      max_execution_time = 60


      This option limits the time in seconds a script is allowed to parse input data. OpenEMR requires this option to have the value -1, which means that the max_execution_time is used instead:


      max_input_time = -1


      This option limits the size of a post, including uploaded files. OpenEMR requires this option to have a value of 30M:


      post_max_size = 30M


      This option limits the amount of memory a script is allowed to allocate. OpenEMR requires this option to have a value of 256M:


      memory_limit = 256M

      mysqli.allow_local infile

      This option enables access to local files with LOAD DATA statements. OpenEMR requires this option to be turned on:


      mysqli.allow_local_infile = On

      When you are done adjusting the options, save and exit the file. If you are using nano, you can do that by pressing CTRL+X, then Y and ENTER to confirm.

      Next, you’ll need to reload the Apache web server for changes to take effect:

      • sudo systemctl reload apache2

      When your webserver has reloaded, you should be ready to proceed to the next step.

      Step 4 — Downloading OpenEMR

      In this step, you will download OpenEMR and prepare its files for installation. To start, download OpenEMR using the command wget, which retrieves files from the internet:

      • wget

      Next, extract the files using the tar command. The xvzf argument is used to tell the shell to extract the files (x), name the files extracted (v), uncompress the files with gzip (z), and use the file named in the command (f).

      When the files are done being extracted, you should have a directory named openemr-5.0.2. Change the directory name to openemr using the mv command:

      Next, move the directory to your HTML directory:

      • sudo mv openemr /var/www/html/

      You now need to change the ownership of the directory. Use the chown command and R flag to set the owner of all files and the group associated with openemr to www-data:

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

      For the installation process, OpenEMR also requires you to change the permissions of the sqlconf.php file so that all users can read and write the file but cannot execute it. After the installation is finished, we’ll change these permissions once again to secure your setup. These permissions can be granted with the chmod command using 666 as argument:

      • sudo chmod 666 /var/www/html/openemr/sites/default/sqlconf.php

      After you change the permissions for the sqlconf.php file, you are ready to proceed to the next step.

      Step 4 — Installing OpenEMR

      In this step, you will install OpenEMR through a web browser and configure the Apache web server. Open a web browser and navigate to http://server_ip/openemr, replacing server_ip with the IP address of your server.

      If everything is working correctly, the browser should display the OpenEMR Setup page:

      OpenEMR setup page

      Click Proceed to Step 1. You should now be directed to a new OpenEMR Setup page for Step 1 of the installation process:

      OpenEMR setup page — Step 1

      On the new page, select I have already created a database as you already created an OpenEMR database in Step 3 of this tutorial. Then click Proceed to Step 2.

      Your browser should now display Step 2 of the OpenEMR Setup:

      OpenEMR setup page — Step 2
      In the Login and Password fields in the MySQL Server Details section, enter the username and password you picked in Step 3.

      In the OpenEMR Initial User Details section, create an Initial User Login Name and password.

      If you’d like to enable 2 Factor Authentication for the initial user, click the option Enable 2FA.

      Then click Create DB and User. It may take a few minutes for the next page to load. This page will verify the successful creation of the user and database:

      OpenEMR setup page — Step 3

      Click Proceed to Step 4 to continue. The next page will confirm the creation and configuration of the Access Control List:

      OpenEMR setup page — Step 4

      Click Proceed to Step 5 to continue. The next page will show you the required PHP configurations for OpenEMR. Your current configuration should match their requirements as you already adjusted them in Step 4.

      OpenEMR setup page — Step 5

      Click Proceed to Step 6 to continue. The next page will show you how to configure your Apache Web Server for OpenEMR:

      OpenEMR setup page — Step 6

      To configure the Apache Web Server for OpenEMR, create a new configuration file named openemr.conf. You can do that from your terminal using the nano editor:

      • sudo nano /etc/apache2/sites-available/openemr.conf

      Inside the file, paste the following directives:


       <Directory "/var/www/html/openemr">
            AllowOverride FileInfo
            Require all granted
        <Directory "/var/www/html/openemr/sites">
            AllowOverride None
        <Directory "/var/www/html/openemr/sites/*/documents">
            Require all denied

      Save and close the file. Then, restart Apache so that the changes are loaded:

      • sudo systemctl restart apache2

      Next, return to the browser and click Proceed to Select a Theme. On the next page, select a theme and click Proceed to Final Step:

      OpenEMR setup page — Step 7

      You should now be directed to the final setup page with confirmation details regarding your installation:

      OpenEMR setup page — Final Step

      This page will also give the user name and password details for your initial user. Make sure to have these details available before you leave the page. When you are ready, click the link at the bottom to start using OpenEMR.

      A window will pop up asking whether you want to register your installation. After making your choice, log in to OpenEMR with your initial user credentials. Once you are logged in, your browser should display the OpenEMR dashboard:

      OpenEMR dashboard

      Before going any further, make sure to change the file permissions as indicated in the next step.

      Step 5 — Changing FileSystem Permissions

      To improve the security of the system, OpenEMR advises users to change permissions of several files after installation. In this step, you will change the permissions of these files to further restrict read and write access.

      First, you will change the permissions of the sqlconf.php file whose permissions you modified in Step 3 to give the owner read and write access and group members only read access.

      These permissions can be granted with the chmod command using 644 as the argument:

      • sudo chmod 644 openemr/library/sqlconf.php

      Next, you will change the permissions of several other files to allow only the file owner to read and write the file.

      Grant these permissions by using the chmod command with the 600 argument on the following files:

      • sudo chmod 600 openemr/acl_setup.php
      • sudo chmod 600 openemr/acl_upgrade.php
      • sudo chmod 600 openemr/setup.php
      • sudo chmod 600 openemr/sql_upgrade.php
      • sudo chmod 600 openemr/gacl/setup.php
      • sudo chmod 600 openemr/ippf_upgrade.php

      Your files should now have more secure permission settings.

      In addition to changing file permissions, OpenEMR’s documentation strongly advises additional steps for securing each of OpenEMR’s components. These steps include deleting scripts in OpenEMR after installation, enforcing strong passwords, enabling HTTPS-only traffic, adjusting the firewall, and hardening Apache. Make sure to visit OpenEMR’s security documentation to learn more about how you can best protect your OpenEMR installation.


      You have now installed OpenEMR on an Ubuntu 20.04 server using Apache, MySQL, and PHP. For instructions on pointing a domain name to your server, you can follow our guide How To Point to DigitalOcean Nameservers From Common Domain Registrars. For OpenEMR documentation, you can visit the OpenEMR Wiki Page.

      Source link

      Cara Menginstal Server Web Apache pada Ubuntu 20.04


      Server HTTP Apache adalah server web yang paling banyak digunakan di dunia. Server web ini menyediakan banyak fitur canggih termasuk modul yang dapat dimuat secara dinamis, dukungan media yang kokoh, dan integrasi ekstensif dengan perangkat lunak populer lainnya.

      Dalam panduan ini, kami akan menjelaskan cara menginstal server web Apache di server Ubuntu 20.04 Anda.


      Sebelum Anda memulai panduan ini, Anda harus memiliki pengguna non-root reguler dengan privilese sudo yang terkonfigurasi di server Anda. Selain itu, Anda akan perlu mengaktifkan firewall dasar untuk memblokir porta non-esensial. Anda dapat mempelajari cara mengonfigurasi akun pengguna reguler dan menyiapkan firewall untuk server Anda dengan mengikuti Panduan penyiapan server awal untuk Ubuntu 20.04 dari kami.

      Ketika Anda sudah memiliki akun, log masuk sebagai pengguna non-root untuk memulai.

      Langkah 1 — Menginstal Apache

      Apache tersedia di dalam repositori perangkat lunak asali Ubuntu, yang memungkinkan Apache terinstal dengan menggunakan alat manajemen paket konvensional.

      Mari kita mulai dengan memperbarui indeks paket lokal untuk mencerminkan perubahan hulu terbaru:

      Lalu, instal paket apache2:

      Setelah mengonfirmasi instalasi, apt akan menginstal Apache dan semua dependensi yang diperlukan.

      Langkah 2 — Menyesuaikan Firewall

      Sebelum menguji Apache, Anda perlu memodifikasi pengaturan firewall untuk mengizinkan akses dari luar ke porta web asali. Dengan asumsi bahwa Anda telah mengikuti instruksi di prasyarat, Anda seharusnya memiliki firewall UFW yang terkonfigurasi untuk membatasi akses ke server Anda.

      Selama instalasi, Apache mendaftarkan dirinya dengan UFW untuk menyediakan beberapa profil aplikasi yang dapat digunakan untuk mengaktifkan atau menonaktifkan akses ke Apache melalui firewall.

      Buat daftar profil aplikasi ufw dengan mengetik:

      Anda akan menerima daftar profil aplikasi:


      Available applications: Apache Apache Full Apache Secure OpenSSH

      Seperti yang ditunjukkan oleh keluaran, ada tiga profil yang tersedia untuk Apache:

      • Apache: Profil ini hanya membuka porta 80 (lalu lintas web normal dan tidak terenkripsi)
      • Apache Full: Profil ini membuka baik porta 80 (lalu lintas web normal dan tidak terenkripsi) serta porta 443 (lalu lintas terenkripsi TLS/SSL)
      • Apache Secure: Profile ini hanya membuka porta 443 (lalu lintas terenkripsi TLS/SSL)

      Anda disarankan untuk mengaktifkan profil yang paling ketat yang masih akan mengizinkan lalu lintas yang telah Anda konfigurasikan. Karena kita belum mengonfigurasi SSL untuk server kita dalam panduan ini, kita hanya perlu mengizinkan lalu lintas pada porta 80:

      Anda dapat memverifikasi perubahan dengan mengetik:

      Keluaran akan memberi daftar lalu lintas HTTP yang diizinkan:


      Status: active To Action From -- ------ ---- OpenSSH ALLOW Anywhere Apache ALLOW Anywhere OpenSSH (v6) ALLOW Anywhere (v6) Apache (v6) ALLOW Anywhere (v6)

      Seperti yang ditunjukkan oleh keluaran, profil itu telah diaktifkan untuk mengizinkan akses ke server web Apache.

      Langkah 3 — Memeriksa Server Web Anda

      Pada akhir proses instalasi, Ubuntu 20.04 memulai Apache. Server web seharusnya sudah aktif dan berjalan.

      Periksa dengan sistem init systemd untuk memastikan layanan sedang berjalan dengan mengetik:

      • sudo systemctl status apache2


      ● apache2.service - The Apache HTTP Server Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2020-04-23 22:36:30 UTC; 20h ago Docs: Main PID: 29435 (apache2) Tasks: 55 (limit: 1137) Memory: 8.0M CGroup: /system.slice/apache2.service ├─29435 /usr/sbin/apache2 -k start ├─29437 /usr/sbin/apache2 -k start └─29438 /usr/sbin/apache2 -k start

      Sebagaimana dikonfirmasi oleh keluaran ini, layanan telah berhasil dimulai. Namun, cara terbaik untuk menguji ini adalah dengan benar-benar meminta satu laman dari Apache.

      Anda dapat mengakses laman landas Apache asali untuk mengonfirmasi bahwa perangkat lunak berjalan dengan baik melalui alamat IP Anda. Jika Anda tidak mengetahui alamat IP server Anda, Anda bisa mendapatkannya dengan beberapa cara berbeda dari baris perintah.

      Coba ketik ini di prompt perintah server Anda:

      Anda akan mendapat beberapa alamat yang dipisahkan dengan spasi. Anda dapat mencoba masing-masing alamat di peramban web Anda untuk melihat apakah alamat itu berfungsi.

      Opsi lain adalah dengan menggunakan alat Icanhazip, yang akan memberi Anda alamat IP publik Anda sebagaimana yang terbaca dari lokasi lain di internet:

      Saat Anda memiliki alamat IP server Anda, masukkan alamat itu ke dalam bilah alamat peramban Anda:


      Anda akan melihat laman web Apache Ubuntu 20.04 asali:

      Laman asali Apache

      Laman ini mengindikasikan bahwa Apache berfungsi dengan benar. Ini juga mencakup beberapa informasi dasar tentang berkas dan lokasi direktori penting Apache.

      Langkah 4 — Mengelola Proses Apache

      Karena sekarang server web Anda telah aktif dan berjalan, mari kita bahas beberapa perintah manajemen dasar dengan menggunakan systemctl.

      Untuk menghentikan server web Anda, ketik:

      • sudo systemctl stop apache2

      Untuk memulai server web saat berhenti, ketik:

      • sudo systemctl start apache2

      Untuk menghentikan lalu memulai layanan lagi, ketik:

      • sudo systemctl restart apache2

      Jika Anda hanya membuat perubahan konfigurasi, Apache seringkali dapat memuat ulang tanpa memutus koneksi. Untuk melakukan ini, gunakan perintah ini:

      • sudo systemctl reload apache2

      Secara asali, Apache dikonfigurasikan untuk memulai secara otomatis saat server melakukan boot. Jika ini bukan apa yang Anda inginkan, Anda dapat menonaktifkan perilaku ini dengan mengetik:

      • sudo systemctl disable apache2

      Untuk mengaktifkan kembali layanan agar memulai saat boot, ketik:

      • sudo systemctl enable apache2

      Apache sekarang akan memulai secara otomatis saat server melakukan boot kembali.

      Langkah 5 — Menyiapkan Hos Virtual (Disarankan)

      Ketika menggunakan server web Apache, Anda dapat menggunakan hos virtual (mirip seperti blok server di Nginx) untuk mengenkapsulasi detail konfigurasi dan menjadi hos untuk lebih dari satu domain dari server tunggal. Kita akan menyiapkan domain bernama your_domain, tetapi Anda harus menggantinya dengan nama domain Anda sendiri. Jika Anda menyiapkan nama domain dengan DigitalOcean, silakan merujuk ke Dokumentasi Jaringan kami.

      Apache pada Ubuntu 20.04 memiliki satu blok server yang aktif secara asali, yang dikonfigurasi untuk menyajikan dokumen-dokumen dari direktori /var/www/html. Meskipun ini berfungsi baik untuk situs tunggal, ini bisa menjadi sulit dijalankan jika Anda menjadi hos dari beberapa situs. Alih-alih memodifikasi /var/www/html, mari kita ciptakan struktur direktori di dalam /var/www untuk situs your_domain, dengan membiarkan /var/www/html di tempatnya sebagai direktori asali yang akan disajikan jika permintaan klien tidak cocok dengan situs lain apa pun.

      Buat direktori untuk your_domain sebagai berikut:

      • sudo mkdir /var/www/your_domain

      Selanjutnya, tentukan kepemilikan direktori dengan variabel lingkungan $USER:

      • sudo chown -R $USER:$USER /var/www/your_domain

      Izin dari root web Anda seharusnya benar jika Anda belum mengubah nilai umask Anda, yang menetapkan izin berkas asali. Untuk memastikan izin Anda benar dan memperbolehkan pemilik untuk membaca, menulis, dan mengeksekusi berkas, sementara memberikan izin hanya untuk membaca dan mengeksekusi kepada grup dan lainnya, Anda dapat memasukkan perintah berikut:

      • sudo chmod -R 755 /var/www/your_domain

      Selanjutnya, buat laman index.html dengan menggunakan nano atau editor favorit Anda:

      • sudo nano /var/www/your_domain/index.html

      Di dalam, tambahkan HTML sampel berikut ini:


              <title>Welcome to Your_domain!</title>
              <h1>Success!  The your_domain virtual host is working!</h1>

      Simpan dan tutup berkas saat Anda sudah selesai.

      Agar Apache menyajikan konten ini, kita perlu menciptakan berkas hos virtual dengan arahan yang benar. Alih-alih memodifikasi berkas konfigurasi asali yang terletak di /etc/apache2/sites-available/000-default.conf secara langsung, mari kita ciptakan yang baru di /etc/apache2/sites-available/your_domain.conf:“

      • sudo nano /etc/apache2/sites-available/your_domain.conf

      Tempel di blok konfigurasi berikut, yang serupa dengan yang asali, tetapi diperbarui untuk nama domain dan direktori baru kita:


      <VirtualHost *:80>
          ServerAdmin webmaster@localhost
          ServerName your_domain
          ServerAlias www.your_domain
          DocumentRoot /var/www/your_domain
          ErrorLog ${APACHE_LOG_DIR}/error.log
          CustomLog ${APACHE_LOG_DIR}/access.log combined

      Perhatikan bahwa kita telah memperbarui DocumentRoot ke direktori baru kita dan ServerAdmin ke suatu surel yang dapat diakses oleh administrator situs your_domain. Kita juga telah menambah dua arahan: ServerName, yang menjadikan domain dasar yang seharusnya sesuai dengan definisi hos virtual ini, dan ServerAlias, yang mendefinisikan nama lebih lanjut yang seharusnya sesuai, sebagaimana jika itu adalah nama dasarnya.

      Simpan dan tutup berkas saat Anda sudah selesai.

      Mari kita aktifkan berkas dengan alat a2ensite:

      • sudo a2ensite your_domain.conf

      Nonaktifkan situs asali yang ditetapkan di dalam 000-default.conf:

      • sudo a2dissite 000-default.conf

      Selanjutnya, mari kita uji untuk kesalahan konfigurasi:

      • sudo apache2ctl configtest

      Anda akan menerima keluaran berikut:


      Syntax OK

      Mulai ulang Apache untuk menerapkan perubahan Anda:

      • sudo systemctl restart apache2

      Apache sekarang seharusnya menyajikan nama domain Anda. Anda dapat menguji ini dengan bernavigasi ke http://your_domain, di mana Anda akan melihat sesuatu seperti ini:

      Contoh hos virtual Apache

      Langkah 6 — Membiasakan Diri dengan Berkas dan Direktori Penting Apache

      Kini setelah Anda mengetahui cara mengelola layanan Apache sendiri, Anda perlu waktu beberapa menit untuk membiasakan diri dengan beberapa direktori dan berkas penting.


      • /var/www/html: Konten web aktual, yang secara asali hanya terdiri dari halaman Apache asali yang Anda lihat sebelumnya, yang disajikan dari direktori /var/www/html. Ini dapat diubah dengan mengubah berkas konfigurasi Apache.

      Konfigurasi Server

      • /etc/apache2: Direktori konfigurasi Apache. Semua berkas konfigurasi Apache berada di sini.
      • /etc/apache2/apache2.conf: Berkas konfigurasi utama Apache. Ini dapat dimodifikasi untuk membuat perubahan pada konfigurasi global Apache. Berkas ini bertanggung jawab atas pemuatan banyak berkas lainnya di dalam direktori konfigurasi.
      • /etc/apache2/port.conf: Berkas ini menetapkan porta yang akan didengar oleh Apache. Secara asali, Apache mendengarkan porta 80 dan sebagai tambahan juga mendengarkan porta 443 saat modul yang menyediakan kemampuan SSL diaktifkan.
      • /etc/apache2/sites-available/: Direktori di mana hos virtual per situs dapat disimpan. Apache tidak akan menggunakan berkas konfigurasi yang ditemukan dalam direktori ini kecuali jika berkas tersebut terhubung ke direktori sites-enabled. Biasanya, semua konfigurasi blok server dilakukan di dalam direktori ini, lalu diaktifkan dengan menghubungkannya ke direktori lain dengan perintah a2ensite.
      • /etc/apache2/sites-enabled/: Direktori tempat menyimpan hos virtual per situs yang diaktifkan. Biasanya, ini diciptakan dengan menghubungkan ke berkas konfigurasi yang ditemukan di dalam direktori sites-available dengan a2ensite. Apache membaca berkas konfigurasi dan tautan yang ditemukan di dalam direktori ini saat memulai atau memuat ulang untuk mengompilasi konfigurasi yang lengkap.
      • /etc/apache2/conf-available/, /etc/apache2/conf-enabled: Direktori ini memiliki hubungan yang sama seperti sites-available dan direktori sites-enabled, tetapi digunakan untuk menyimpan fragmen konfigurasi yang tidak seharusnya berada di hos virtual. Berkas dalam direktori conf-available dapat diaktifkan dengan perintah a2enconf dan dinonaktifkan dengan perintah a2disconf.
      • /etc/apache2/mods-available/, /etc/apache2/mods-enabled/: Direktori-direktori ini berisi modul yang tersedia dan diaktifkan, secara berurutan. Berkas yang berakhiran .load berisi fragmen untuk memuat modul tertentu, sedangkan berkas yang berakhiran .conf berisi konfigurasi untuk modul tersebut. Modul dapat diaktifkan dan dinonaktifkan dengan menggunakan perintah a2enmod dan a2dismod.

      Log Server

      • /var/log/apache2/access.log: Secara asali, setiap permintaan ke server web Anda direkam di dalam berkas log ini kecuali Apache dikonfigurasikan untuk melakukan sebaliknya.
      • /var/log/apache2/error.log: Secara asali, semua kesalahan direkam di dalam berkas ini. Arahan LogLevel dalam konfigurasi Apache menetapkan seberapa banyak detail yang akan dicatat dalam log kesalahan.


      Setelah server web Anda terinstal, Anda memiliki banyak opsi untuk tipe konten yang Anda dapat layani dan teknologi yang Anda dapat gunakan untuk menciptakan pengalaman yang lebih kaya.

      Jika Anda ingin membangun tumpukan aplikasi yang lebih lengkap, Anda dapat membaca artikel yang berjudul cara mengonfigurasi tumpukan LAMP pada Ubuntu 20.04

      Source link

      Cara Mengamankan Apache dengan Let’s Encrypt pada Ubuntu 20.04


      Let’s Encrypt adalah Otoritas Sertifikat (CA) yang memfasilitasi perolehan dan penginstalan sertifikat TLS/SSL gratis, yang dengan demikian mengaktifkan HTTPS terenkripsi pada server web. Ini menyederhanakan proses dengan menyediakan klien perangkat lunak, Certbot, yang berusaha mengotomatiskan sebagian besar (jika bukan semua) langkah yang diperlukan. Saat ini, seluruh proses memperoleh dan menginstal sertifikat secara sepenuhnya berjalan otomatis baik pada Apache dan Nginx.

      Dalam panduan ini, kita akan menggunakan Certbot untuk memperoleh sertifikat SSL gratis untuk Apache pada Ubuntu 20.04, dan memastikan agar sertifikat ini disiapkan untuk diperbarui secara otomatis.

      Tutorial ini menggunakan berkas hos virtual yang terpisah alih-alih berkas konfigurasi asali Apache untuk menyiapkan situs web yang akan diamankan dengan Let’s Encrypt. Kami menyarankan untuk menciptakan berkas hos virtual Apache yang baru untuk setiap domain yang dihos di server, karena ini membantu menghindari kesalahan umum dan mempertahankan berkas konfigurasi asali sebagai penyiapan fallback.


      Untuk mengikuti tutorial ini, Anda akan membutuhkan:

      • Satu server Ubuntu 20.04 yang disiapkan dengan mengikuti tutorial penyiapan server awal untuk Ubuntu 20.04 ini, termasuk satu pengguna non-root sudo dan satu firewall.

      • Nama domain yang terdaftar penuh. Tutorial ini akan menggunakan your_domain sebagai contoh di seluruh tulisan ini. Anda dapat membeli nama domain dari Namecheap, mendapat nama domain gratis di Freenom, atau menggunakan registrar domain pilihan Anda.

      • Kedua catatan DNS berikut disiapkan untuk server Anda. Anda dapat mengikuti pengantar DigitalOcean DNS ini untuk detail tentang cara menambahkannya.

        • Catatan A dengan your_domain yang mengarahkan ke alamat IP publik server Anda.
        • Catatan A dengan www.your_domain yang mengarahkan ke alamat IP publik server Anda.
      • Apache yang terinstal dengan mengikuti Cara Menginstal Apache pada Ubuntu 20.04. Pastikan Anda memiliki berkas hos virtual untuk domain Anda. Tutorial ini akan menggunakann /etc/apache2/sites-available/your_domain.conf sebagai contoh.

      Langkah 1 — Menginstal Certbot

      Untuk memperoleh sertifikat SSL dengan Let’s Encrypt, kita perlu menginstal perangkat lunak Certbot pada server Anda terlebih dahulu. Kita akan menggunakan repositori paket Ubuntu asali untuk itu.

      Kita membutuhkan dua paket: certbot dan python3-certbot-apache. Paket yang disebut terakhir adalah plugin yang mengintegrasikan Certbot dengan Apache, yang memungkinkan kita untuk mengotomatiskan perolehan sertifikat dan mengonfigurasi HTTPS di dalam server web Anda dengan satu perintah.

      • sudo apt install certbot python3-certbot-apache

      Anda juga akan diminta mengonfirmasi instalasi dengan menekan Y, lalu ENTER.

      Certbot sekarang telah terinstal di server Anda. Pada langkah selanjutnya, kita akan memverifikasi konfigurasi Apache untuk memastikan hos virtual Anda telah disiapkan dengan benar. Ini akan memastikan bahwa skrip klien certbot akan mampu mendeteksi domain Anda dan mengonfigurasi ulang server web Anda untuk menggunakan sertifikat SSL yang baru saja dihasilkan secara otomatis.

      Langkah 2 — Memeriksa Konfigurasi Hos Virtual Apache Anda

      Agar dapat memperoleh dan mengonfigurasi SSL untuk server web Anda secara otomatis, Certbot perlu menemukan hos virtual yang benar yang ada di dalam berkas konfigurasi Apache Anda. Nama (atau nama-nama) domain server Anda akan diambil dari arahan ServerName dan ServerAlias yang ditetapkan di dalam blok konfigurasi VirtualHost Anda.

      Jika Anda mengikuti langkah penyiapan hos virtual dalam tutorial instalasi Apache, Anda harusnya memiliki blok VirtualHost yang disiapkan untuk domain Anda di /etc/apache2/sites-available/your_domain.conf dengan arahan ServerName dan juga ServerAlias yang sudah diatur dengan benar.

      Untuk memeriksa ini, buka berkas hos virtual untuk domain Anda dengan menggunakan nano atau editor teks yang Anda sukai:

      • sudo nano /etc/apache2/sites-available/your_domain.conf

      Temukan baris ServerName dan ServerAlias yang sudah ada. Baris itu akan terlihat seperti ini:


      ServerName your_domain
      ServerAlias www.your_domain

      Jika Anda telah menyiapkan ServerName dan ServerAlias seperti ini, Anda dapat keluar dari editor teks Anda dan melanjutkan ke langkah selanjutnya. Jika Anda menggunakan nano, Anda dapat keluar dengan mengetik CTRL+X, lalu Y, dan ENTER untuk mengonfirmasi.

      Jika konfigurasi hos virtual Anda saat ini tidak sesuai dengan contoh, perbaruilah supaya sesuai contoh. Setelah Anda selesai, simpan berkas itu dan keluar dari editor. Lalu, jalankan perintah berikut untuk memvalidasi perubahan Anda:

      • sudo apache2ctl configtest

      Anda akan mendapat pesan Syntax OK sebagai respons. Jika Anda mendapat pesan kesalahan, buka kembali berkas host virtual dan periksa adanya kesalahan tik atau karakter yang hilang. Setelah sintaks berkas konfigurasi Anda benar, muat ulang Apache supaya perubahan itu diterapkan:

      • sudo systemctl reload apache2

      Dengan perubahan ini, Certbot akan dapat menemukan blok VirtualHost yang benar dan memperbaruinya.

      Selanjutnya, mari kita perbarui firewall untuk mengizinkan lalu lintas HTTPS.

      Langkah 3 — Mengizinkan HTTPS Melewati Firewall

      Jika firewall UFW Anda sudah diaktifkan, seperti yang disarankan oleh panduan prasyarat, Anda perlu menyesuaikan pengaturan untuk mengizinkan lalu lintas HTTPS. Setelah instalasi, Apache mendaftarkan beberapa profil aplikasi UFW yang berbeda. Kita dapat memanfaatkan profil Apache Full untuk mengizinkan baik lalu lintas HTTP dan HTTPS pada server Anda.

      Untuk memverifikasi lalu lintas seperti apa yang diizinkan pada server Anda, Anda dapat menggunakan:

      Jika Anda telah mengikuti salah satu panduan instalasi Apache kami, keluaran Anda akan terlihat seperti ini, yang berarti bahwa hanya lalu lintas HTTP pada porta 80 yang diizinkan untuk saat ini:


      Status: active To Action From -- ------ ---- OpenSSH ALLOW Anywhere Apache ALLOW Anywhere OpenSSH (v6) ALLOW Anywhere (v6) Apache (v6) ALLOW Anywhere (v6)

      Untuk menambah lalu lintas HTTPS masuk, izinkan profil “Apache Full” dan hapus profil “Apache” yang lewah lainnya:

      • sudo ufw allow 'Apache Full'
      • sudo ufw delete allow 'Apache'

      Status Anda sekarang akan terlihat seperti ini:


      Status: active To Action From -- ------ ---- OpenSSH ALLOW Anywhere Apache Full ALLOW Anywhere OpenSSH (v6) ALLOW Anywhere (v6) Apache Full (v6) ALLOW Anywhere (v6)

      Anda sekarang siap untuk menjalankan Certbot dan memperoleh sertifikat Anda.

      Langkah 4 — Memperoleh Sertifikat SSL

      Certbot menyediakan berbagai cara untuk memperoleh sertifikat SSL melalui plugin. Plugin Apache akan menangani konfigurasi ulang Apache dan memuat ulang konfigurasi itu ketika diperlukan. Untuk menggunakan plugin ini, ketik yang berikut:

      Skrip ini akan meminta Anda menjawab serangkaian pertanyaan untuk mengonfigurasi sertifikat SSL Anda. Pertama, skrip ini akan meminta alamat surel Anda yang valid. Surel ini akan digunakan untuk pemberitahuan pembaruan dan keamanan:


      Saving debug log to /var/log/letsencrypt/letsencrypt.log Plugins selected: Authenticator apache, Installer apache Enter email address (used for urgent renewal and security notices) (Enter 'c' to cancel): you@your_domain

      Setelah menyediakan alamat surel yang valid, tekan ENTER untuk melanjutkan ke langkah selanjutnya. Anda kemudian akan diminta mengonfirmasi apakah Anda menyetujui ketentuan layanan dari Let’s Encrypt. Anda dapat mengonfirmasi dengan menekan A lalu ENTER:

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Please read the Terms of Service at You must
      agree in order to register with the ACME server at
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      (A)gree/(C)ancel: A

      Selanjutnya, Anda akan ditanya apakah mau membagi surel Anda dengan Electronic Frontier Foundation untuk menerima berita dan informasi lainnya. Jika Anda tidak ingin berlangganan konten mereka, ketik N. Jika Anda mau, ketik Y. Lalu, tekan ENTER untuk melanjutkan ke langkah selanjutnya.

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Would you be willing to share your email address with the Electronic Frontier
      Foundation, a founding partner of the Let's Encrypt project and the non-profit
      organization that develops Certbot? We'd like to send you email about our work
      encrypting the web, EFF news, campaigns, and ways to support digital freedom.
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      (Y)es/(N)o: N

      Langkah selanjutnya akan meminta Anda untuk menginformasikan Certbot terkait Anda ingin mengaktifkan HTTPS untuk domain yang mana. Nama-nama domain yang terdaftar secara otomatis diperoleh dari konfigurasi hos virtual Apache Anda, itu sebabnya penting untuk memastikan bahwa Anda memiliki pengaturan ServerName dan ServerAlias yang dikonfigurasi dengan benar di dalam hos virtual Anda. Jika Anda ingin mengaktifkan HTTPS untuk semua nama domain yang terdaftar (disarankan), Anda dapat mengosongkan prompt itu dan tekan ENTER untuk melanjutkan. Jika tidak, pilih domain yang Anda ingin aktifkan HTTPS-nya dengan membuat daftar dari setiap nomor yang sesuai, yang dipisahkan dengan koma dan/atau spasi, lalu tekan ENTER.

      Which names would you like to activate HTTPS for?
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      1: your_domain
      2: www.your_domain
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Select the appropriate numbers separated by commas and/or spaces, or leave input
      blank to select all options shown (Enter 'c' to cancel):

      Anda akan melihat keluaran seperti ini:

      Obtaining a new certificate
      Performing the following challenges:
      http-01 challenge for your_domain
      http-01 challenge for www.your_domain
      Enabled Apache rewrite module
      Waiting for verification...
      Cleaning up challenges
      Created an SSL vhost at /etc/apache2/sites-available/your_domain-le-ssl.conf
      Enabled Apache socache_shmcb module
      Enabled Apache ssl module
      Deploying Certificate to VirtualHost /etc/apache2/sites-available/your_domain-le-ssl.conf
      Enabling available site: /etc/apache2/sites-available/your_domain-le-ssl.conf
      Deploying Certificate to VirtualHost /etc/apache2/sites-available/your_domain-le-ssl.conf

      Selanjutnya, Anda akan diminta memilih apakah Anda ingin lalu lintas HTTP dialihkan ke HTTPS atau tidak. Dalam praktiknya, itu berarti saat seseorang mengunjungi situs web Anda melalui saluran yang tidak terenkripsi (HTTP), dia akan secara otomatis dialihkan ke alamat HTTPS dari situs web Anda. Pilih 2 untuk mengaktifkan pengalihan, atau 1 jika Anda ingin mempertahankan baik HTTP dan HTTPS sebagai metode yang terpisah untuk mengakses situs web Anda.

      Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      1: No redirect - Make no further changes to the webserver configuration.
      2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
      new sites, or if you're confident your site works on HTTPS. You can undo this
      change by editing your web server's configuration.
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

      Setelah langkah ini, konfigurasi Certbot selesai, dan Anda akan melihat catatan terakhir tentang sertifikat baru Anda, di mana Anda dapat menemukan berkas yang dihasilkan, dan bagaimana cara menguji konfigurasi Anda dengan menggunakan alat eksternal yang menganalisis keaslian sertifikat Anda:

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Congratulations! You have successfully enabled https://your_domain and
      You should test your configuration at:
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
       - Congratulations! Your certificate and chain have been saved at:
         Your key file has been saved at:
         Your cert will expire on 2020-07-27. To obtain a new or tweaked
         version of this certificate in the future, simply run certbot again
         with the "certonly" option. To non-interactively renew *all* of
         your certificates, run "certbot renew"
       - Your account credentials have been saved in your Certbot
         configuration directory at /etc/letsencrypt. You should make a
         secure backup of this folder now. This configuration directory will
         also contain certificates and private keys obtained by Certbot so
         making regular backups of this folder is ideal.
       - If you like Certbot, please consider supporting our work by:
         Donating to ISRG / Let's Encrypt:
         Donating to EFF:          

      Sertifikat Anda sekarang sudah terinstal dan dimuat ke konfigurasi Apache. Coba muat ulang situs Anda dengan menggunakan https:// dan perhatikan indikator keamanan di peramban Anda. Peramban akan menunjukkan bahwa situs Anda sudah diamankan dengan benar, biasanya dengan adanya ikon kunci di dalam bilah alamat.

      Anda dapat menggunakan SSL Labs Server Test untuk memverifikasi nilai sertifikat Anda dan memperoleh informasi mendetail tentang hal itu, dari sudut pandang layanan eksternal.

      Di langkah selanjutnya yang juga merupakan langkah terakhir, kita akan menguji fitur pembaruan otomatis Certbot, yang menjamin bahwa sertifikat Anda akan diperbarui secara otomatis sebelum tanggal kedaluwarsa.

      Langkah 5 — Memverifikasi Pembaruan Otomatis Certbot

      Sertifikat Let’s Encrypt hanya berlaku selama 90 hari. Kebijakan ini diterapkan untuk mendorong pengguna supaya mengotomatiskan proses pembaruan sertifikatnya, serta memastikan bahwa sertifikat yang disalahgunakan atau kunci yang dicari akan kedaluwarsa lebih cepat daripada seharusnya.

      Paket certbot yang kita instal menangani pembaruan dengan memasukkan skrip pembaruan ke /etc/cron.d, yang dikelola oleh layanan systemctl yang bernama certbot.timer. Skrip ini berjalan dua kali sehari dan secara otomatis memperbarui sertifikat apa pun yang berada dalam waktu 30 hari dari tanggal kedaluwarsa.

      Untuk memeriksa status layanan ini dan memastikan bahwa layanan sudah aktif dan berjalan, Anda dapat menggunakan:

      • sudo systemctl status certbot.timer

      Anda akan medapat keluaran yang mirip dengan ini:


      ● certbot.timer - Run certbot twice daily Loaded: loaded (/lib/systemd/system/certbot.timer; enabled; vendor preset: enabled) Active: active (waiting) since Tue 2020-04-28 17:57:48 UTC; 17h ago Trigger: Wed 2020-04-29 23:50:31 UTC; 12h left Triggers: ● certbot.service Apr 28 17:57:48 fine-turtle systemd[1]: Started Run certbot twice daily.

      Untuk menguji proses pembaruan, Anda dapat melakukan uji coba dengan certbot:

      • sudo certbot renew --dry-run

      Jika Anda tidak melihat kesalahan, maka Anda sudah siap. Ketika diperlukan, Certbot akan memperbarui sertifikat Anda dan memuat ulang Apache untuk menerapkan perubahan itu. Jika proses pembaruan otomatis itu terus-menerus gagal, Let’s Encrypt akan mengirim pesan ke surel yang Anda tentukan, memperingatkan Anda saat sertifikat Anda akan berakhir.


      Dalam tutorial ini, Anda telah menginstal certbot klien Let’s Encrypt, mengonfigurasi dan menginstal sertifikat SSL untuk domain Anda, dan mengonfirmasi bahwa layanan pembaruan otomatis Certbot sudah aktif di dalam systemctl. Jika Anda memiliki pertanyaan lebih lanjut tentang cara menggunakan Certbot, dokumentasi mereka adalah tempat yang baik untuk memulai.

      Source link