In this guide, we focus on advanced scenarios for installing Osclass. While a standard installation on shared hosting (or simple VPS) typically involves uploading files, creating a database, and running the web-based installer, large-scale or specialized environments (like cloud platforms, Ubuntu-based servers with Nginx, or Kubernetes clusters) require additional steps. This article combines standard installation concepts with instructions for IBM Cloud and Ubuntu (Nginx & Let’s Encrypt) to help you deploy Osclass in more robust settings.
For large-scale setups, confirm you have enough CPU, RAM, and storage to handle potentially thousands or millions of listings.
The following steps summarize a classic Osclass setup, typically used on simpler environments or shared hosting:
/public_html
).http://yourdomain.com
in a browser. Osclass will prompt you to run the installer.yourdomain.com/oc-admin
.IBM Cloud offers a more enterprise-ready environment for running Osclass with Kubernetes clusters, block storage, and integrated Helm charts. Below is an outline:
kubectl get pods -n osclass
.After reaching the public URL, complete the web installer steps to finalize your Osclass environment on IBM Cloud.
For advanced users self-hosting on Ubuntu, we can install Osclass with an Nginx web server and secure it using Let’s Encrypt SSL.
sudo apt-get update
sudo apt-get install nginx mariadb-server \
php7.4 php7.4-fpm php7.4-mysql php7.4-gd php7.4-xml \
curl unzip -y
Adjust PHP version or package names as required (e.g., php8.x
).
sudo mysql
CREATE DATABASE osclass;
GRANT ALL PRIVILEGES ON osclass.* \
TO 'osclass'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;
EXIT;
cd /var/www/html
sudo mkdir osclass
cd osclass
sudo wget https://github.com/Dis555/Osclass/releases/download/4.2.0/Osclass-Evolution4.2.0.zip
sudo unzip Osclass-Evolution4.2.0.zip
sudo chown -R www-data:www-data /var/www/html/osclass
sudo chmod -R 755 /var/www/html/osclass
sudo nano /etc/nginx/sites-available/osclass.conf
Add a server block like:
server {
listen 80;
server_name yourdomain.com;
root /var/www/html/osclass;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
}
Enable and restart Nginx:
sudo ln -s /etc/nginx/sites-available/osclass.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
sudo apt-get install python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com
Follow prompts, agree to terms, and choose whether to redirect HTTP to HTTPS. Once done, your site will have a valid SSL certificate and be served over HTTPS.
https://yourdomain.com
.https://yourdomain.com/oc-admin
to manage your classifieds.oc-content
folder. Cloud providers often offer snapshot features or scheduled backups.Whether deploying Osclass on a straightforward shared hosting plan or leveraging IBM Cloud Kubernetes or an Ubuntu server with Nginx and Let’s Encrypt, the process is flexible. The standard installation procedure remains the same: place files on the server, configure a database, and finalize settings via the web-based installer. For more complex environments, you’ll incorporate container orchestration, specialized block storage, advanced SSL, or manual LEMP configuration to ensure top performance and security.