|
|
|
@@ -82,17 +82,17 @@ PHP version 5.6 or newer is recommended (PHP 7.x is supported). Please note that
|
|
|
|
|
|
|
|
|
|
MySQL 5.5, 5.6 and 5.7 are supported, also MariaDB replacement is supported and apparently offering better performance.
|
|
|
|
|
|
|
|
|
|
Apache 2.2 and 2.4 are supported. Also Nginx has been proven to work fine, see [wiki page here](https://github.com/jekkos/opensourcepos/wiki/Local-Deployment-using-LEMP)
|
|
|
|
|
Apache 2.2 and 2.4 are supported. Also Nginx has been proven to work fine, see [wiki page here](https://github.com/opensourcepos/opensourcepos/wiki/Local-Deployment-using-LEMP)
|
|
|
|
|
|
|
|
|
|
Raspberry PI based installations proved to work, see [wiki page here](https://github.com/jekkos/opensourcepos/wiki/Installing-on-Raspberry-PI---Orange-PI-(Headless-OSPOS))
|
|
|
|
|
Raspberry PI based installations proved to work, see [wiki page here](https://github.com/opensourcepos/opensourcepos/wiki/Installing-on-Raspberry-PI---Orange-PI-(Headless-OSPOS))
|
|
|
|
|
|
|
|
|
|
For Windows based installations please read [the wiki](https://github.com/jekkos/opensourcepos/wiki) and also existing closed issues as this topic has been covered well in all the variants and issues.
|
|
|
|
|
For Windows based installations please read [the wiki](https://github.com/opensourcepos/opensourcepos/wiki) and also existing closed issues as this topic has been covered well in all the variants and issues.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Local install
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
1. Dowload the latest [stable release](https://github.com/jekkos/opensourcepos/releases) from github or [unstable build](https://bintray.com/jekkos/opensourcepos/opensourcepos/view/files?sort=updated&order=asc#files) from bintray
|
|
|
|
|
1. Dowload the latest [stable release](https://github.com/opensourcepos/opensourcepos/releases) from github or [unstable build](https://bintray.com/jekkos/opensourcepos/opensourcepos/view/files?sort=updated&order=asc#files) from bintray
|
|
|
|
|
2. Create/locate a new mysql database to install open source point of sale into
|
|
|
|
|
3. Execute the file database/database.sql to create the tables needed
|
|
|
|
|
4. unzip and upload Open Source Point of Sale files to web server
|
|
|
|
@@ -139,13 +139,13 @@ month of uptime on the platform. A full setup will only take about 2 minutes by
|
|
|
|
|
3. Login to docker cloud
|
|
|
|
|
4. Associate your docker cloud account with your previously created digital ocean account under settings
|
|
|
|
|
5. Create a new node on DigitalOcean through the `Infrastructure > Nodes` tab. Fill in a name (ospos) and choose a region near to you. We recommend to choose a node with minimum 1G RAM for the whole stack
|
|
|
|
|
6. Click [](https://cloud.docker.com/stack/deploy/?repo=https://github.com/jekkos/opensourcepos)
|
|
|
|
|
7. Othewise create a new stack under `Applications > Stacks` and paste the [contents of docker-cloud.yml](https://github.com/jekkos/opensourcepos/blob/master/docker-cloud.yml) from the source repository in the text field and hit `Create and deploy`
|
|
|
|
|
6. Click [](https://cloud.docker.com/stack/deploy/?repo=https://github.com/opensourcepos/opensourcepos)
|
|
|
|
|
7. Othewise create a new stack under `Applications > Stacks` and paste the [contents of docker-cloud.yml](https://github.com/opensourcepos/opensourcepos/blob/master/docker-cloud.yml) from the source repository in the text field and hit `Create and deploy`
|
|
|
|
|
8. Find your website url under `Infrastructure > Nodes > <yournode> > Endpoints > web`
|
|
|
|
|
9. Login with default username/password admin/pointofsale
|
|
|
|
|
10. DNS name for this server can be easily configured in the DigitalOcean control panel
|
|
|
|
|
|
|
|
|
|
More info [on maintaining a docker](https://github.com/jekkos/opensourcepos/wiki/Docker-cloud-maintenance) install can be found on the wiki
|
|
|
|
|
More info [on maintaining a docker](https://github.com/opensourcepos/opensourcepos/wiki/Docker-cloud-maintenance) install can be found on the wiki
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Language Translations
|
|
|
|
@@ -153,7 +153,7 @@ Language Translations
|
|
|
|
|
|
|
|
|
|
To help us with OSPOS translations please use [Weblate website here](http://weblate.jpeelaer.net) 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](https://github.com/jekkos/opensourcepos/wiki/Adding-translations) to find our Translations Guideline.
|
|
|
|
|
Please also read the [wiki page here](https://github.com/opensourcepos/opensourcepos/wiki/Adding-translations) to find our Translations Guideline.
|
|
|
|
|
|
|
|
|
|
Only with the help of the community we can keep language translations up to date.
|
|
|
|
|
|
|
|
|
@@ -187,14 +187,14 @@ FAQ
|
|
|
|
|
|
|
|
|
|
* If sales and receiving views don't show properly, please make sure BCMath lib (`php-bcmath`) is installed. On windows check php.ini and make sure php_bcmath extension is not commented out
|
|
|
|
|
|
|
|
|
|
* If the following error is seen in sales module `Message: Class 'NumberFormatter' not found` then you don't have `php5-intl` extension installed. Please check the [wiki](https://github.com/jekkos/opensourcepos/wiki/Localisation-support#php5-intl-extension-installation) to resolve this issue on your platform. If you use WAMP, please read [issue #949](https://github.com/jekkos/opensourcepos/issues/949)
|
|
|
|
|
* If the following error is seen in sales module `Message: Class 'NumberFormatter' not found` then you don't have `php5-intl` extension installed. Please check the [wiki](https://github.com/opensourcepos/opensourcepos/wiki/Localisation-support#php5-intl-extension-installation) to resolve this issue on your platform. If you use WAMP, please read [issue #949](https://github.com/opensourcepos/opensourcepos/issues/949)
|
|
|
|
|
|
|
|
|
|
* If you read errors containing messages with Socket word in it, please make sure you have installed PHP Sockets support (e.g. go to PHP.ini and make sure all the needed modules are not commented out. This means `php5-gd`, `php-intl` and `php-sockets`. Restart the web server)
|
|
|
|
|
|
|
|
|
|
* If you installed your OSPOS under a web server subdir, please edit public/.htaccess and go to the lines with comment `if in web root` and `if in subdir comment above line, uncomment below one and replace <OSPOS path> with your path` and follow the instruction on the second comment line. If you face more issues please read [issue #920](https://github.com/jekkos/opensourcepos/issues/920) for more help
|
|
|
|
|
* If you installed your OSPOS under a web server subdir, please edit public/.htaccess and go to the lines with comment `if in web root` and `if in subdir comment above line, uncomment below one and replace <OSPOS path> with your path` and follow the instruction on the second comment line. If you face more issues please read [issue #920](https://github.com/opensourcepos/opensourcepos/issues/920) for more help
|
|
|
|
|
|
|
|
|
|
* If the avatar pictures are not shown in Items or at Item save time you get an error, please make sure your public and subdirs are assigned to the correct owner and the access permission is set to 755
|
|
|
|
|
|
|
|
|
|
* If you have problems with the encryption support or you get an error please make sure `php5-mcrypt` is installed
|
|
|
|
|
|
|
|
|
|
* If you have suhosin installed and face an issue with CSRF, please make sure you read [issue #1492](https://github.com/jekkos/opensourcepos/issues/1492)
|
|
|
|
|
* If you have suhosin installed and face an issue with CSRF, please make sure you read [issue #1492](https://github.com/opensourcepos/opensourcepos/issues/1492)
|
|
|
|
|
FrancescoUK