Site icon WPDig.com

How to install Drupal on Ubuntu Linux with Apache

This short post shows students and new users how to install and use the Drupal content management system (CMS) on Ubuntu Linux with the Apache HTTP web server. This post will also have a link to set up free Let’s Encrypt SSL certificates to protect your Drupal websites and apps.

Drupal is a free and open source CMS based on PHP and MySQL that also has many features and thousands of plugins and templates or themes. If you want to create a website or online store, Drupal might be the easiest way to do it, especially if you will need user support to manage and maintain the site.

This tutorial is based on Ubuntu Linux. We will install the Apache web server, the MariaDB database server and the PHP modules. We will also link to another post that will show you how to protect your Drupal website using free Let’s Encrypt SSL certificates.

For more information on Drupal, see their Homepage

To start installing Drupal on Ubuntu Linux, follow the steps below:

How to install Apache on Ubuntu Linux

As mentioned above, we will use the Apache web server to run Drupal. Drupal requires a web server to function, and Apache is one of the most popular open source web servers available today.

To install Apache on Ubuntu, run the following commands:

sudo apt update
sudo apt install apache2

After installing Apache, the following commands can be used to stop, start and enable Apache services always start every time the server starts.

sudo systemctl stop apache2.service
sudo systemctl start apache2.service
sudo systemctl enable apache2.service

To test if Apache is installed and working, open your web browser and look for the IP address or hostname of the server.

http: // localhost

If you see the above page in the browser, then Apache is working as expected.

How to install MariaDB on Ubuntu Linux

A database server is required for Drupal to work. Drupal stores its content in a database and MariaDB is probably the best database server available to run Drupal.

MariaDB is fast, secure, and the default server for almost all Linux servers. To install MariaDB, run the following commands:

sudo apt install mariadb-server
sudo apt install mariadb-client

After installing MariaDB, the following commands can be used to stop, start and enable MariaDB services always start when the server starts.

sudo systemctl stop mariadb.service
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Then run the following commands to protect the database server with a root password if you were not prompted to do so during installation.

sudo mysql_secure_installation

When prompted, use the guide below to respond:

If you've just installed MariaDB, and haven't set the root password yet, you should just press enter here.

Enter current password for root (enter for none): PRESS ENTER

Switch to unix_socket authentication [Y/n] n

Change the root password? [Y/n] n

Remove anonymous users? [Y/n] y

Disallow root login remotely? [Y/n] y

Remove test database and access to it? [Y/n] y

Reload privilege tables now? [Y/n] y

All done!

To verify and validate that MariaDB is installed and working, log into the database console using the following commands:

sudo mysql -u root -p

It should automatically log into the database server as we started the login request as root. Only root can login without password and only from server console.

If you see a screen similar to the one shown above, then the server installed successfully.

How to install PHP on Ubuntu Linux

As we also mentioned above, we are installing PHP on Ubuntu as Drupal requires it. The PHP packages are added to the Ubuntu repositories. Repository versions may not be the latest. If you need to install the latest versions, you will need to add a third-party PPA repository.

In a third-party repository with the latest versions of PHP, run the following commands.

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:ondrej/php

At the time of writing, the latest version of PHP 8.0.

sudo apt update

Then run the following commands to install PHP 8.0 and related modules.

sudo apt install php8.0 php8.0-common php8.0-mysql php8.0-gmp php8.0-curl php8.0-intl php8.0-mbstring php8.0-xmlrpc php8.0-gd php8.0-xml php8.0-cli php8.0-zip

Next, you’ll want to change some PHP configuration settings that work great with Drupal. Run the following commands to open the default PHP configuration file.

sudo nano /etc/php/8.0/apache2/php.ini

Then change the line settings to be somewhat aligned with the lines below. Save your changes and exit.

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 256M
cgi.fix_pathinfo = 0
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = America/Chicago

How to create a Drupal database in Ubuntu

At this point, we are ready to create a Drupal database. As mentioned above, Drupal uses databases to store its content.

To create a database for Drupal, run the following commands:

sudo mysql -u root -p

Then create a database called drupaldb

CREATE DATABASE drupaldb;

Next, create a database user named drupaldbuser and set password

CREATE USER 'drupaldbuser'@'localhost' IDENTIFIED BY 'new_password_here';

Then grant the user full access to the database.

GRANT ALL ON drupaldb.* TO 'drupaldbuser'@'localhost' WITH GRANT OPTION;

Finally, save your changes and exit.

FLUSH PRIVILEGES;
EXIT;

How to download Drupal

We are ready to download Drupal and start configuring it. First, run the following commands to download the latest version of Drupal from its repository.

To get the latest version of Drupal, you may want to use the GitHub repository. Install Composer, Curl, and other dependencies to get started …

sudo apt install curl git
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

After installing curl and Composer above, change to Apache’s root directory and download the Drupal packages from GitHub. Always replace the branch number with the last branch.

To see the Drupal versions, see this page.

cd /var/www/
sudo git clone --branch 9.2.5 https://git.drupal.org/project/drupal.git
cd /var/www/drupal
sudo composer install

Then run the command below to allow www-data user own the Drupal directory.

sudo chown -R www-data:www-data /var/www/drupal/
sudo chmod -R 755 /var/www/drupal/

How to configure Apache for Drupal

We have downloaded the Drupal content into a new folder that we call Drupal. Now, let’s configure Apache to create a new server block to use with our Drupal website. You can create so many server blocks with Apache.

To do that, run the following commands to create a new configuration file called drupal.conf at / etc / apache2 / sites-available / directory to host our Drupal server block.

sudo nano /etc/apache2/sites-available/drupal.conf

In the archive, copy and paste the content below in the archive and save it.

<VirtualHost *:80>
  ServerName example.com
  ServerAlias www.example.com
  ServerAdmin admin@example.com
  DocumentRoot /var/www/drupal
    
  <Directory /var/www/drupal/>
       Options FollowSymlinks
       AllowOverride All
       Require all granted
  </Directory>

       ErrorLog ${APACHE_LOG_DIR}/error.log
       CustomLog ${APACHE_LOG_DIR}/access.log combined
    
</VirtualHost>

Save the file and close.

After saving the above file, run the following commands to enable the new file that contains our Drupal server block. Restart Apache after that.

sudo systemctl reload apache2

At this stage, Drupal is ready and can be started by going to the server’s IP or hostname.

http://localhost

However, we want to make sure our server is protected with free Let’s Encrypt SSL certificates. So, continue below to learn how to generate Let’s Encrypt SSL certificate for websites.

How to set up Let’s Encrypt for Drupal

We have written an excellent post on how to generate and manage Let’s Encrypt SSL certificates for Apache web server. You can use that post to apply here for your Drupal website.

To read the post on how to generate Let’s Encrypt SSL certificates for the website, click the link below:

How to configure Let’s Encrypt on Ubuntu Linux with Apache

If you managed to generate a Let’s Encrypt SSL certificate, you need to reopen the server block for our Drupal website by running the following commands.

sudo nano /etc/apache2/sites-available/drupal.conf

The new Drupal server block settings should look similar to the following line. Take notes on the highlighted lines.

  • The first server block listens on port 80. It contains a 301 redirect to redirect HTTP to HTTPS.
  • The second server block listens on port 443. It contains a 301 redirect to redirect www to a domain other than www.
<VirtualHost *:80>
  ServerName example.com
  ServerAlias www.example.com

  Redirect permanent / https://example.com/
</VirtualHost>

<VirtualHost *:443>
  ServerName example.com
  ServerAlias www.example.com
  DocumentRoot /var/www/drupal

  Protocols h2 http:/1.1

  <If "%{HTTP_HOST} == 'www.example.com'">
    Redirect permanent / https://example.com/
  </If>
  
  ErrorLog ${APACHE_LOG_DIR}/example.com-error.log
  CustomLog ${APACHE_LOG_DIR}/example.com-access.log combined

  SSLEngine On
  SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
  SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
  SSLOpenSSLConfCmd DHParameters "/etc/ssl/certs/dhparam.pem"
  
  SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384

  SSLProtocol All -SSLv2 -SSLv3 -TLSv1 -TLSv1.1
  SSLCompression off
  SSLUseStapling on

  Header always set Strict-Transport-Security "max-age=63072000"

  <Directory /var/www/drupal/>
       Options FollowSymlinks
       AllowOverride All
       Require all granted
  </Directory>
 
</VirtualHost>

Save the file above, then restart Apache and PHP using the commands below.

sudo systemctl reload apache2

Finally, if everything went according to plan, you should be able to start the Drupal setup wizard by navigating to the server’s hostname or IP address via HTTPS.

https://example.com/

A Drupal setup wizard should appear. Follow the wizard to complete the setup.

Select the installation language and then click Save and continue.

On the next screen, choose the standard installation option to include commonly used features that are preconfigured.

These are the most popular options for most websites running Drupal CMS.

Then enter your database connection information and click Save and continue.

After that, enter the site information, including site name, site administrator email address, username and password, and continue.

When you’re done, Drupal should be installed and ready to go. Log in as an administrator and start setting up your site.

In the future, when you want to upgrade to a new released version, just run the following commands to upgrade …

sudo composer update /var/www/drupal/core --with-dependencies
cd /var/www/drupal
sudo composer require drush/drush
cd /var/www/drupal/vendor/drush/drush
./drush updatedb
./drush cr
sudo chown www-data:www-data /var/www/drupal
sudo chmod 755 /var/www/drupal

That is all!

Conclusion:

In this tutorial we have seen how to install Drupal on Ubuntu Linux with a link to configure Let’s Encrypt. If you find any errors above or have something to add, please use the comment form below.

Exit mobile version