Search by tag: apache

2 articles

Apache: enable HTTPS

To enable HTTP Secure (HTTPS) on Apache, we first enable the modules called mod_ssl and mod_socache_shmcb in the main Apache configuration file, located at /etc/httpd/conf/httpd.conf:

LoadModule socache_shmcb_module modules/
LoadModule ssl_module modules/

We include SSL own configuration file:

# Secure (SSL/TLS) connections
Include conf/extra/httpd-ssl.conf

In this file, we also set a document root (or keep the default path depending on where we put our web application) and a server name. We use the default 443 port.

DocumentRoot "/srv/http/secure_application"
ServerName localhost:443

We can also edit the path to our certificate files but I kept mines at the default location:

SSLCertificateFile "/etc/httpd/conf/server.crt"
SSLCertificateKeyFile "/etc/httpd/conf/server.key"

Finally we need to get or generate our certificate. I have created a self-signed one for my development environment but it is not recommended on live servers. As written above, I kept the default path so in this example we are going to create our certificate in that folder. We start by generating our key:

$ cd /etc/httpd/conf/
$ sudo openssl genrsa -out server.key 4096
Generating RSA private key, 4096 bit long modulus [...]

This is our private key so we need to restrict permissions to make sure no one else can read it:

$ sudo chmod 600 server.key

Then we need to generate the Certificate Signing Requests (CSR). We are prompted for a few informations which can be left blank but the important one is Common Name, which must be the domain of our site like or * But for our development environment, we just write localhost.

$ sudo openssl req -new -key server.key -out server.csr
You are about to be asked to enter information that will be incorporated into your certificate request.
Common Name (e.g. server FQDN or YOUR name) []:localhost

Finally we generate our certificate and restart Apache:

$ sudo openssl x509 -req -days 3650 -in server.csr -signkey server.key -out server.crt
$ sudo systemctl restart httpd.service

Now we can browse to https://localhost/ and make the browser display a worrying alert:

Warning message displayed by Firefox

This is caused by our self-signed certificate which has no security value (if you see this on a live website, you should follow the advice of "Getting out of here!"). In Firefox, we can click on "I Understand the Risks" then on the "Add Exception..." button. This will display a pop-up window where we can tell Firefox to not bother us again when accessing our server. Check "Permanently store this exception" then click "Confirm Security Exception" which will close the pop-up and reload the page:

Pop-up window "Add Security Exception"

Upgrade Apache to 2.4 from 2.2 on Arch Linux, using PHP-FPM

Since the first article, more than six weeks ago, Apache has been updated to version 2.4.9 which allows for a simpler configuration with php-fpm, mod_proxy_fcgi and mod_proxy_handler.

The following setup does not use mod_php, which requires mod_mpm_prefork and ProxyPassMatch directives as shown in my first article.

First, install php-fpm and mod_proxy_handler (the latter comes from AUR).

# yaourt -S php-fpm mod_proxy_handler

Then update /etc/php/php-fpm.conf:

listen =
;listen = /run/php-fpm/php-fpm.sock
listen.allowed_clients =

In the main Apache configuration file located at /etc/httpd/conf/httpd.conf, no more need to use mpm_prefork_module and ProxyPassMatch. Just append the following:

LoadModule proxy_handler_module modules/
<filesmatch .php="">
    SetHandler "proxy:fcgi://"

Verify that the following line is active (uncommented) as it should be by default:

LoadModule proxy_fcgi_module modules/

Edit the dir_module directive:

<ifmodule dir_module="">
    DirectoryIndex index.php index.html

Remove or comment out the php module if you had it in your old config:

#LoadModule php5_module modules/
#Include conf/extra/php5_module.conf

Restart apache and php-fpm:

# systemctl restart httpd.service php-fpm.service

If it is your first installation of php-fpm and you use Apache often, you might want to start its daemon automatically:

# systemctl enable php-fpm.service