Blue Flower

Getting Apache installed to get a web server running!

Installing Apache2.4

Make sure you update ports and then run the following commands:


# cd /usr/ports/www/apache24
# make install clean

Configuring apache2

Lets edit the httpd.conf file:


# vi /usr/local/etc/apache24/httpd.conf

Scroll down and change the following settings. The optional settings I will put OPTIONAL before the setting:


OPTIONAL: Listen 80 - You can change this default option if you have more than one apache server running on your network

User www - Changes what user apache runs as

Group www - Changes what group apache runs as

ServerAdmin This email address is being protected from spambots. You need JavaScript enabled to view it. - change This email address is being protected from spambots. You need JavaScript enabled to view it. to your email address.

DocumentRoot "/usr/local/www/apache24/data" - I don't usually use the default path. I put my www documents on a seperate drive.

Directory "/usr/local/www/apache24/data" - Change this to the same path as DocumentRoot (See above)

<Directory /usr/local/www/apache24/> Change this to the root of your vhosts folder

DirectoryIndex index.html index.html.var - add any pages you would use. For instance, add index.php if you use php pages

OPTIONAL: #CustomLog /var/log/httpd-access.log combined - I usually leave this commented unless you want to use this to track users looking at your site

ScriptAlias /cgi-bin/ "/usr/local/www/cgi-bin/" - change this to your cgi-bin path

Directory "/usr/local/www/cgi-bin"> - change this to the same path as ScriptAlias /cgi-bin above

OPTIONAL: This will make your directory listings look a lot better

Include etc/apache22/extra/httpd-autoindex.conf

We now need to tell Apache to run on startup. Please run the following:


# echo 'apache24_enable="YES"' >> /etc/rc.conf

Now lets tell apache to start:


# /usr/local/etc/rc.d/apache24 start

If you get no errors, apache should be running. Look at the page by opening a browser to http://localhost or replace localhost with the IP or the actual hostname of the box. If you went with the DocumentRoot defaults, You will see an apache test page until you get your site up and going. If you are behind a router or firewall, make sure you forward the apache port (Port 80) to the FreeBSD box otherwise you won't be able to get there from here.

Configuring SSL

Before you continue on I have a new guide for letsencrypt that allows you to have a free SSL cert. Take a look at https://freebsdrocks.net/index.php/documents/10-installing-applications/154-letsencrypt

Let's get SSL Configured and Installed:

(FROM http://www.bsdguides.org/guides/freebsd/webserver/apache_ssl_php_mysql.php)


# mkdir /usr/local/etc/apache24/ssl.key
# mkdir /usr/local/etc/apache24/ssl.crt
# chmod 0700 /usr/local/etc/apache24/ssl.key
# chmod 0700 /usr/local/etc/apache24/ssl.crt

Create Certificate

Now, you need to understand that one server can hold multiple certificates, but only one per listening IP address. So, if your server is listening on one IP address, you can only have one certificate for the server. Follow me so far? All of your virtual domains can share the same certificate, but clients will get warning prompts when they connect to a secure site where the certificate does not match the domain name. If your server is listening on multiple IP addresses, your virtual hosts have to be IP-based -- not name-based. This is something to consider when creating your certificate.

Change to your root dir by typing in the following command. We want to save this configuration there as a backup.


# cd /root
# openssl genrsa -des3 -out server.key 2048

You will now be prompted to enter in a password. Write this down as you will need it later. We need to make a Certificate Signing Request (CSR):


# openssl req -new -key server.key -out server.csr

Enter your password when it asks for it. Make sure you enter your FQDN for the "Common Name" portion.

Self-signing your Certificate

You could always pay money to Verisign or Thawte for this but it costs $$$. Here is the way to do it:


# openssl x509 -req -days 365 -in /root/server.csr -signkey /root/server.key -out /root/server.crt

Now your cert is good for 365 days. If you want to make it longer, go right ahead and do so :-)

If you would like more information about SSL Certs, go to http://httpd.apache.org/docs-2.0/ssl/ssl_faq.html#aboutcerts

Now we need to copy the certs to the right place:


# cp /root/server.key /usr/local/etc/apache24/ssl.key/
# cp /root/server.crt /usr/local/etc/apache24/ssl.crt/

Now to give them the right permissions as well:


# chmod 0400 /usr/local/etc/apache24/ssl.key/server.key
# chmod 0400 /usr/local/etc/apache24/ssl.crt/server.crt

We will now want to copy the default httpd-ssl.conf from the extras folder to the Includes folder:


# cd /usr/local/etc/apache24/extra
# vi httpd-ssl.conf

Now modify the following:



DocumentRoot "/usr/local/www/data" - Change the path to your httpd.conf document root.

ServerName www.example.com:443 - Change www.example.com to your domain name.

ServerAdmin This email address is being protected from spambots. You need JavaScript enabled to view it. Change this to your email address

ErrorLog /var/log/httpd-error.log - You can leave this or comment it out.

TransferLog /var/log/httpd-access.log - You can leave this or comment it out.

SSLCertificateFile "/usr/local/etc/apache24/ssl.crt/server.crt"

SSLCertificateKeyFile "/usr/local/etc/apache24/ssl.key/server.key"

#SSLSessionCache "shmcb:/var/run/ssl_scache(512000)"

Next we need to open up /usr/local/etc/apache24/httpd.conf and comment out the following three lines:


LoadModule ssl_module libexec/apache24/mod_ssl.so

LoadModule socache_shmcb_module libexec/apache24/mod_socache_shmcb.so

Include etc/apache24/extra/httpd-ssl.conf

Now run the following:


# /usr/local/etc/rc.d/apache24 stop
# /usr/local/etc/rc.d/apache24 start

The start means it will start in ssl mode to serve both http:// and https:// addresses. This used to be /usr/local/etc/rc.d/apache24 sslstart but that command has been depreciated.

The URL below includes instructions on how to remove the pass phrase prompt when apache starts

http://httpd.apache.org/docs/2.0/ssl/ssl_faq.html#removepassphrase

Configuring php for Apache

This section is pretty easy. Just run the following:


# cd /usr/ports/lang/php56
# make install clean

We will want to set the time zone in the php.ini. Lets copy the file over and then edit php.ini.


# cd /usr/local/etc/
# cp php.ini-production php.ini
# vi php.ini

Inside the php.ini set the following. If you're not EST then see the following supported timezones:

http://php.net/manual/en/timezones.php

date.timezone = 'America/New_York'

If you do not set the timezone messages will not appear with a timestamp in dovecot.

Next, we want to configure apache to use php5.6


# cd /usr/ports/www/mod_php56
# make install clean

and look for the first AddType section in /usr/local/etc/httpd.conf and add this to next line below the AddType section


AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps

Next go to DirectoryIndex and make sure index.php is part of it like so:


DirectoryIndex index.php index.html

We now need to load the accf http module as seen below.


# echo 'accf_http_load="YES"' >> /boot/loader.conf

Now rather than rebooting the box, we can load the module manually by running:


# kldload accf_http

and then if you start Apache, You won't get that error.

Now run the following command to restart apache.


# /usr/local/etc/rc.d/apache24 restart

You will now have apache with SSL and PHP support!