Build Status Join the chat at https://gitter.im/jekkos/opensourcepos devDependency Status Dependency Status GitHub version Translation status

Introduction

Open Source Point of Sale is a web based point of sale system. The main features are:

The software is written in PHP language, it uses MySQL (or MariaDB) as data storage back-end and has a simple but intuitive user interface.

The latest 3.x version is a complete overhaul of the original software. It is now based on Bootstrap 3 using Bootswatch themes, and still uses CodeIgniter 3 as framework. It also has improved functionality and security.

Deployed to a Cloud it’s a SaaS (Software as a Service) solution.

DEMO

A demo version of the latest master version can be found on our Demo server. This is a containerized install which will be reinitialized when new functionality is added to the code repository.

LOGIN using

Installation

Please refrain from creating issues about installation issues before reading the FAQ and going through existing github issues. We have a build pipeline that checks the sanity of our latest repository commit and in case the application itself is broken then our build will be as well.

This application can be setup in many different ways and we only support the ones described in the INSTALL file linked below.

Read the INSTALL.md in our repository.

License

Open Source Point of Sale is licensed under MIT terms with an important addition:

The footer signature “You are using Open Source Point Of Sale” with version, hash and link to the original distribution of the code MUST BE RETAINED, MUST BE VISIBLE IN EVERY PAGE and CANNOT BE MODIFIED.

Also worth noting:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

For more details please read the file LICENSE.

It’s important to understand that althought you are free to use the software the copyright stays and the license agreement applies in all cases. Therefore any actions like:

In short you are free to use the software but you cannot claim any property on it.

Any person or company found breaching the license agreement will have a bunch of monkeys at the door ready to destroy their servers.

Keep the Machine Running

If you like the project, and you are making money out of it in some form, then consider buying us a coffee so we can keep adding features.

Donate

Language Translations

To help us with OSPOS translations please use Weblate website here and sign up. After registering you can subscribe to different languages and you will be notified once a new translation is added.

Please also read the wiki page here to find our Translations Guideline.

Only with the help of the community we can keep language translations up to date.

Reporting Bugs

If you are taking a release candidate code please make sure you always run the latest database upgrade script and you took the latest code from master. Please DO NOT post issues if you have not done those step.

Bug reports must follow this schema:

  1. Ospos version string with git commit hash (see ospos footer)
  2. OS name and version running your Web Server (e.g. CentOS 6.9, Ubuntu 16.4, Windows 10)
  3. Web Server name and version (e.g. Apache 2.2, Apache 2.4, Nginx 1.12, Nginx 1.13)
  4. Database name and version (e.g. MySQL 5.5, MySQL 5.6, MySQL 5.7, MariaDB 10.0, MariaDB 10.1, MariaDB 10.2)
  5. PHP version (e.g. 5.5, 5.6, 7.0, 7.1)
  6. Language selected in OSPOS (e.g. English, Spanish)
  7. Any configuration of OSPOS that you changed
  8. Exact steps to reproduce the issue (test case)
  9. Optionally some screenshots to illustrate each step

If above information is not provided in full, your issue will be tagged as pending. If missing information is not provided within a week we will close your issue.

FAQ