OSClass is an open source project for classifieds. In a few steps you can build a classified site. Some features: easy installation, multi-language, extensibility through plugins, search engines friendly (sitemap, robots, urls seo-friendly) and a lot more features.


Here’s a quick step-by-step guide of the installation process:

  1. Download and unzip the OSClass package.
  2. Move the OSClass unzipped files to the desired location on your server.
  3. Execute the OSClass installation script by accessing oc-includes/osclass/install.php from your browser:
    • If you’ve installed it in the domain’s root directory, you’ll have to go to:
    • If you’ve installed it in a subdirectory inside the domain, classifieds, for example, go to:
  4. Follow the installer’s instructions:
    • First of all, make sure the server has the required permissions to write in the files and directories specified. This will allow you to create a basic configuration file as well as upload images, documents, etc.
    • Step 1: Add your access details to the database. If you haven’t created it yet, the installer will ask for another account with permissions that allows it to do it for you.
    • Step 2: Add the basic installation details and select your classfieds site’s reach: international, local, regional…
    • Step 3: Choose the categories you want to use on your site. If you don’t select a category, you’ll have to add it later from your admin panel.
    • Your installation is finished! Use the automatically generated password to access your admin panel (/oc-admin).

How to upgrade

OSClass will show an autoupgrade message at admin panel if a new (and stable) version is available. Only need follow instructions for begin the upgrade. We recommend to do a backup before you attempt to upgrade your OSClass installation, you could perform that from the admin panel (if you modified any core file, it will probably be replaced by new version software. Be carefull).


The Autoupgrade feature will perform the following steps for you :

  • Step 1: Check if there's a new version os OSClass.
  • Step 2: Download it.
  • Step 3: Unzip it.
  • Step 4: Remove old files, copy new ones (remember: if you edited any core file, it will probable be replaced by a new one).
  • Step 5: Perform changes in the tables (if necessary).
  • Step 6: Perform extra-actions (if necessary).

Follow the link and after a few moments you will be enjoying a new version of your favorite open source classifieds software. Had you expected more steps or difficult instructions? Sorry! but we made that easy.

Manual upgrade

You could also upgrade OSClass downloading the upgrade package, unzip it and replace the files on your server with the ones on the package. Then run manually oc-includes/osclass/upgrade-funcs.php for do upgrade complete.

If you experienced any problem during the process, please don't hesitate in contact us in OSClass Support Forums. We recommend to perform a backup of database and files before each upgrade. You could backup your data from the "Backup" option in the admin panel. If you want to run the autoupgrade manually you could do that from the following URL :

Online Resources

If you have any questions that aren't addressed in this document, please look at the online resources:

OSClass Wiki
The wiki is where all information about OSClass is placed.
OSClass Blog
This is where you'll find the latest updates and news related to OSClass.
OSClass Support Forums
If you've looked everywhere and still can't find an answer. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.


OSClass is released under the GPLv3 (see licenses.txt).