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