Learn How To Install Craft CMS on Fedora 29

December 3, 2019

Table of Contents

If you are using a different system, please check our other tutorials.

Craft CMS is an open source CMS written in PHP. Craft CMS source code is hosted on GitHub. This guide will show you how to install Craft CMS with Nginx on a fresh Fedora 29 IT Web Services instance.


Craft requires the following:

  • PHP version 7.0 or greater with the following extensions:
    • ctype
    • curl
    • gd or imagemagick
    • iconv
    • json
    • mbstring
    • openssl
    • pcre
    • pdo
    • pdo mysql
    • pdo postgresql
    • reflection
    • spl
    • zip
    • intl
    • dom
  • MySQL version 5.5 or greater with InnoDB, MariaDB version 5.5 or greater, or PostgreSQL version 9.5 or greater
  • At least 256MB of memory allocated to PHP
  • At least 200MB of free disk space
  • Nginx
  • MariaDB
  • Composer

Before you begin

Check the Fedora version.

cat /etc/fedora-release
# Fedora release 29 (Twenty Nine)

Create a new non-root user account with sudo access and switch to it.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

NOTE: Replace johndoe with your username.

Set up the timezone.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Ensure that your system is up to date.

sudo dnf update -y

Install necessary packages.

sudo dnf install -y wget vim unzip bash-completion

Disable SELinux and Firewall.

sudo setenforce 0 ; sudo systemctl stop firewalld ; sudo systemctl disable firewalld

Step 1 – Install PHP and required PHP extensions

Install PHP.

sudo dnf install -y php-cli php-fpm php-mysqlnd php-mcrypt php-gd php-mbstring php-json php-curl php-xml php-common php-zip

Check the version.

php --version

Start and enable PHP-FPM.

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

Step 2 – Install MariaDB and create a database

Install MariaDB.

sudo dnf install -y mariadb-server

Check the version.

mysql --version

Start and enable MariaDB.

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

Run the mysql_secure_installation script to improve the security of your installation.

sudo mysql_secure_installation

Log in to MariaDB as the root user.

mysql -u root -p
# Enter password:

Create a new database and user, and remember the credentials.

create database dbname;
grant all on dbname.* to 'username' identified by 'password';
flush privileges;

Step 3 – Install and configure Nginx

Install Nginx.

sudo dnf install -y nginx

Check the version.

nginx -v

Start and enable Nginx.

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Configure Nginx. Run sudo vim /etc/nginx/conf.d/craft.conf and populate the file with the following.

server {
    listen [::]:80;
    listen 80;
    server_name example.com;
    root /var/www/craft/web;
    index index.html index.htm index.php;
    charset utf-8;
    location / {
      try_files $uri/index.html $uri $uri/ /index.php?$query_string;
    location ~ [^/].php(/|$) {
      include default.d/php.conf;
      fastcgi_split_path_info ^(.+.php)(/.+)$;
      fastcgi_pass unix:/run/php-fpm/www.sock;
      fastcgi_index index.php;
      include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      fastcgi_param PATH_INFO $fastcgi_path_info;
      fastcgi_param HTTP_PROXY "";       

Test the configuration.

sudo nginx -t

Reload Nginx.

sudo systemctl reload nginx.service

Step 4 – Install Composer

Install Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Check the version.

composer --version
# Composer version 1.8.4 2019-02-11 10:52:10

Step 5 – Download and install Craft CMS

NOTE: Craft can be downloaded with Composer or by manually downloading a .zip or .tar.gz archive. The end result will be the same, so go with whichever route you feel more comfortable with.

Create a document root directory.

sudo mkdir -p /var/www/craft

Change ownership of the /var/www/craft directory to johndoe.

sudo chown -R johndoe:johndoe /var/www/craft

Navigate to the document root.

cd /var/www/craft

Download the latest stable release of Craft CMS via composer.

composer create-project craftcms/craft .

Change ownership of the /var/www/craft directory to nginx.

sudo chown -R nginx:nginx /var/www/craft

Run sudo vim /etc/php-fpm.d/www.conf and set the user and group to nginx. Initially, it will be set to apache.

sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx

Create the /var/lib/php/session/ directory and change ownership to nginx.

sudo mkdir -p /var/lib/php/session && sudo chown -R nginx:nginx /var/lib/php/session

Restart PHP-FPM.

sudo systemctl restart php-fpm.service

In your web browser, go to http://<Hostname>/index.php?p=admin/install, substituting <Hostname> with your web server’s host name. You will be greeted by Craft’s Setup Wizard. To access Craft’s administrative interface, append /admin to your IP/domain.

Need help?

Do you need help setting up this on your own service?
Please contact us and we’ll provide you the best possible quote!