How to Install Osclass on Fedora 28

Published on: Fri, Mar 15, 2019 at 12:35 pm EST

Osclass is an open source project that allows you to easily create a classified site without any technical knowledge. Its source code is hosted on Github. In this tutorial, you will learn how to install Osclass on a Fedora 28 server.

Requirements

  • PHP version 5.6 or greater
  • MySQLi and GD modules for PHP
  • MariaDB database
  • Nginx

Before you begin

Check the Fedora version.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

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.

Ensure that your system is up to date.

sudo dnf check-upgrade || sudo dnf upgrade -y

Set up the timezone.

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

Install necessary packages.

sudo dnf install -y curl git wget vim unzip bash-completion

For simplicity, disable SELinux and Firewall.

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

Install PHP

Install PHP and required PHP extensions.

sudo dnf install -y php php-cli php-fpm php-common php-mysqlnd php-gd php-xml

Check the version.

php --version
# PHP 7.2.8 (cli) (built: Jul 17 2018 05:35:43) ( NTS )

Start and enable PHP-FPM.

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

Install MariaDB and create a database

Install MariaDB.

sudo dnf install -y mariadb-server

Check the version.

mysql --version
# mysql  Ver 15.1 Distrib 10.2.16-MariaDB, for Linux (x86_64) using readline 5.1

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 MariaDB installation.

sudo mysql_secure_installation

Log into MariaDB as the root user.

mysql -u root -p
# Enter password:

Create a new MariaDB database and user for Osclass. Remember the credentials for this new user.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit

Install and configure Nginx

Install Nginx.

sudo dnf install -y nginx

Check the version.

nginx -v
# nginx version: nginx/1.12.1

Start and enable Nginx.

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

Configure Nginx for Osclass. Run sudo vim /etc/nginx/conf.d/osclass.conf and add the following configuration.

server {
    listen 80;
    listen [::]:80;

    server_name example.com; # Check this
    root /var/www/osclass; # Check this

    index index.php index.html index.htm;

    location / {
      try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.(php|phar)(/.*)?$ {
      fastcgi_split_path_info ^(.+\.(?:php|phar))(/.*)$;
      fastcgi_intercept_errors on;
      fastcgi_index  index.php;
      include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME  $document_root$fastcgi_script_name;
      fastcgi_param PATH_INFO $fastcgi_path_info;
      fastcgi_pass unix:/run/php-fpm/www.sock; # Check this
    }
}

Test the configuration.

sudo nginx -t

Reload Nginx.

sudo systemctl reload nginx.service

Install Osclass

Create a document root directory.

sudo mkdir -p /var/www/osclass

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

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

Download and unzip the Osclass package.

cd /var/www/osclass
wget https://static.osclass.org/download/osclass.3.8.0.zip
unzip osclass.3.8.0.zip
rm osclass.3.8.0.zip

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

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

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

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

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

Restart PHP-FPM.

sudo systemctl restart php-fpm.service

Finally, open your favorite web browser and navigate to the URL http://your-server-ip/index.php or http://yourdomain.com/index.php. Complete the required steps to finish the installation. To access the Osclass admin dashboard, append /oc-admin to your URL/IP.