Osclass is a powerful script that allows you to create and manage your own online classifieds website.
With features like customizable themes and plugins, powerful search and filtering options, user registration and management, and free plugins for integration with popular payment gateways.
Osclass is the perfect solution for anyone looking to build a successful online marketplace.
Some of the amazing features of Osclass include:
We welcome contributions of all kinds, from bug fixes to new features. If you're interested in contributing to Osclass, please follow these steps:
npm install
.Osclass is released under the GPLv3 license. See LICENSE for more information.
To get started with Osclass, follow these easy steps:
public_html
directory.oc-includes/osclass/install.php
from your browser:
http://example.com/index.php
or
directly to http://example.com/oc-includes/osclass/install.phphttp://example.com/classifieds/index.php
or directly to http://example.com/classifieds/oc-includes/osclass/install.php
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.
Add your access details to the database. If you havenβt created it yet, the installer will ask for another account with permissions that will allow to do it for you.
Add the basic installation details and select your classifieds siteβs country.
Installation finished. Use the automatically-generated password to access your admin panel (example.com/oc-admin).
Checkout our GitHub Release section to get latest version of osclass.
Do not use master branch for your deployment, it may include untested code. Only use zip file provided in our release section.
First Clone the repository and the submodules.
$> git clone --recursive git@github.com:mindstellar/Osclass.git
Dependencies:
Once you're done, simply cd
to Osclass directory and run docker-compose up -d
. This will initialise and start all the containers, then leave them running in the background.
You can access your application via localhost
, if you're running the containers directly. nginx and mailhog both
respond to any hostname, in case you want to add your own hostname on your /etc/hosts
Service | Address outside containers |
---|---|
Webserver | localhost:5080 |
PhpMyAdmin web interface | localhost:5800 |
MySQL | host: localhost ; port: 5306 |
Mailhog web interface | localhost:5025 |
You'll need to configure osclass to use enabled services:
Service | Hostname | Port number |
---|---|---|
php-fpm | php-fpm | 9000 |
MySQL | mysql | 3306 (default) |
Memcached | memcached | 11211 (default) |
SMTP (Mailhog) | mailhog | 1025 (default) |
Note: you need to cd first to where your docker-compose.yml file lives.
docker-compose up -d
docker-compose up
. You will see a stream of logs for every container
running.docker-compose stop
docker-compose kill
docker-compose logs
docker-compose exec SERVICE_NAME COMMAND
where COMMAND
is whatever you
want to run. Examples:docker-compose exec php-fpm bash
docker-compose exec mysql mysql -uroot -pCHOSEN_ROOT_PASSWORD
Want to help create a pull request from you clone, just make sure of few things
For any support related query, please visit our official support forum.