-
-
Notifications
You must be signed in to change notification settings - Fork 2.2k
Getting Started installations
After reading this read also Getting Started Usage
Please follow the instructions here as closely as possible, otherwise we won't be able to support you in case of issues.
We will be installing a prebuilt version of OSPOS. Do not click on the Green "Clone or Download" button found in the Code view of GitHub. It is NOT a working copy of OSPOS. Instead, in the following instructions, we will be retrieving and installing a prebuilt official release.
-
Terminal windows must be open: in MacOSX at Finder->Accesories->Terminal in Linux at Menu->SystemTools->Terminal, then a window with prompt will show, it's best to elevate to root access with
sudo su
command. -
Dependencies Install: Apache2, MariaDB, PhP with openssl, curl, gd, intl and bcmath, in MAC all these are included in MAMP, in Linux for Deb and RPM based distribution you need
apt-get install apache2 mariadb-server php5-curl php5-mysql php5-gd php5-intl php5-openssl
or/andyum install httpd mysql-server php php-bcmath php-dba php-gd php-openssl
. Debian does not use "php5" bit "php" in their names of the packages. Now finally enable the mod-rewrite module by entering thea2enmod rewrite
command. -
Htdocs working directory: Change the working directory in the current terminal window, assuming the
/var/www/html
as the web root html document directory and you can move to by executingcd /var/www/html
but remember this depends of the Operating System Apache2 install -
Download Retrieve a prebuilt version of OSPOS using the latest release. Execute in same terminal:
wget https://github.com/opensourcepos/opensourcepos/releases/download/3.2.3/opensourcepos.20180613210031.3.2.3.f1cf3d.zip -O osposlastedstable.zip
to later move to the htdoc directory. -
Uncompress to htdocs the download:
cd /var/www/html;unzip osposlastedstable.zip
this will populate all the web server htdocs root directory only for the software. -
Create database and access: executing in same terminal
mysql -u root -e "CREATE SCHEMA ospos;CREATE USER 'admin'@'%' IDENTIFIED BY 'pointofsale';GRANT ALL PRIVILEGES ON ospos . * TO 'admin'@'%' IDENTIFIED BY 'pointofsale' WITH GRANT OPTION;FLUSH PRIVILEGES;"
take in consideratin password administrative privilegies for the database users. -
Populate database with that other command in same terminal
mysql -u admin -ppointofsale -D ospos < /var/www/html/application/database/database.sql
-
Configure the OSPOS index page and encryption key this its by editing the config and htaccess files, can be bypassing but strong recommended set the encryption key at
application/config/config.php
with your owcurrently for security. -
Browsing using the web browser and run from
http://localhost/public
or betterhttp://127.0.0.1/public
-
Login by using username as admin and the password are pointofsale and then enjoy the software.
Now next to Getting Started Usage
-
Terminal windows must be open: in MacOSX at Finder->Accesories->Terminal in Linux at Menu->SystemTools->Terminal, then a window with prompt will show, in Linux flavors must gain root access only for next step with
sudo su
command -
Dependences install: docker.io, please refer to the docker documentation for better instructions: in MAC all included in
docker.img
file by launching it, drag Moby the whale to the Applications folder and later relaunch service from Finder, in Linux for Deb and RPM based distribution areapt-get install docker.io
or/andyum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo;yum install -y docker-ce
respectively, oldstable deb distributions may need "backports" or "external" repositories. After install hit "CRTL+D" to out from root account. -
Dockerplace working directory for the dockerfile of ospos: this it's change the working directory in the current terminal window, assuming the
~
represent your home with a docker root document directory and you can move to by executingmkdir ~/osposdocker;cd ~/osposdocker
but remenber this depends of the Operating System Docker install too. -
Download Retrieve a prebuilt version of OSPOS using the latest release. Execute in same terminal:
wget https://github.com/opensourcepos/opensourcepos/releases/download/3.2.3/opensourcepos.20180613210031.3.2.3.f1cf3d.zip -O osposlastedstable.zip
to later move to the htdoc directory. -
Uncompress to htdocs the download:
tar zxvf osposlastedstable.tar.gz --strip 1 -C ~/osposdocker
this will populate all the docker root image directory only for the software. -
Build+Run the image with following commands
docker-compose build
and then laterdocker-compose up
, take in consideratin password administrative privilegies for the database users.
Now next to Getting Started Usage More info in the wiki page Extras for Docker cloud maintenance must be read.
For Cloud hosting we recommend DigitalOcean
(click here) where you will get a $10 free credit and send a referral back to the project as a donation!
-
Create a Digitalocean account and once complete go log in.
-
Choose a Debian Droplet by click the Create button in the top right hand corner, and later from the dropdown menu.
-
OneClickApp as the LAMP on 9 app, clik the One click apps link. Scroll down, and choose a size. Then scroll down to Choose a datacenter region. Select the region closest to you. Finally select hosname as
osposdo
-
Connecting: Now click the Create button to create your droplet. When your droplet has been created, you'll receive an email from DigitalOcean. This will have the information to log in. You now have the information needed to log in to your server. If you have Mac or Linux, you can use the built-in terminal program SSH as
ssh root@<digitalocean's-ip>
. -
Install software, apache and mysql/mariadb are already, need enable the mod-rewrite module by
a2enmod rewrite
then PHP modules byapt-get install php7.0-intl php7.0-openssl php7.0-bcmath php7.0-curl
Type "Y" when it asks if you want to continue. Finally restart service byservice apache2 restart
-
Download Retrieve a prebuilt version of OSPOS using the latest release. Execute in same terminal:
wget https://github.com/opensourcepos/opensourcepos/releases/download/3.2.3/opensourcepos.20180613210031.3.2.3.f1cf3d.zip -O osposlastedstable.zip
to later move to the htdoc directory. -
Uncompress to htdocs the download:
tar zxvf osposlastedstable.tar.gz --strip 1 -C /var/www/html
this will populate all the web server htdocs root directory only for the software. -
Create database and access: executing in same terminal
mysql -u root -p -e "CREATE SCHEMA ospos;CREATE USER 'admin'@'%' IDENTIFIED BY 'pointofsale';GRANT ALL PRIVILEGES ON ospos . * TO 'admin'@'%' IDENTIFIED BY 'pointofsale' WITH GRANT OPTION;FLUSH PRIVILEGES;"
the DigitalOcean's password are in the filesystem, get withcat /root/.digitalocean_password
command before, and take in consideratin password administrative privilegies for the database users. -
Populate database with that other command in same terminal
mysql -u admin -ppointofsale -D ospos < /var/www/html/application/database/database.sql
-
Configure the OSPOS index page and encription key, this its by editing the config and htaccess files, can be bypassing but strong recommended set the encryption key at
application/config/config.php
with your owcurrently for security. -
Browsing using the web browser and run from
http://<digitalocean-ip>/public
changing the "digitalocean-ip" with that provided in the mail previously received. -
Login by using username as admin and the password are pointofsale and then enjoy the software.
Now next to Getting Started Usage
More info in the wiki page Extras for Docker cloud maintenance must be read.
This section its dedicated to those that will deploy in secure and serious production environments.
Professional install will assumed behing a complex network, that will redirect the port and the path of the OSPOS installation due a front webserver will receive the request and firewall/reverseproxy will redirect to the ospos server install place.
- If you will use reverse proxy redirection due there's no need of a installed firewall in the local webserver OS, that are under a DMZ zone.
- If you dont want hiyacked all the root of your webserver, can defined new port and to that port a new webroot htdocs place where the OSPOS software will reside away of the normal webserver installation.
- Installing "opensourcepos" in windows and localhost
- Local Deployment using LEMP
- Local Deployment using MAMP for Windows
- Local Deployment using Xampp
- Deployment of OSPOS with LEMP on Raspberry Pi 3 Model B
- Installing on Raspberry PI Orange PI (Headless OSPOS)
- OSPOS install lighttpd and mariadb debian like
- Technicals
- Architecture
- Developer guide
- Enable error logging
- Specifications:
- Local Deployment using LEMP
- Local Deployment using MAMP for Windows
- Local Deployment using Xampp
- Deployment of OSPOS with LEMP on Raspberry Pi 3 Model B
- Installing on Raspberry PI Orange PI (Headless OSPOS)
- Local Deployment using Ubuntu 20.04.4 LTS
- OSPOS with Postfix and Gmail SMTP Server
- Local Deployment using Ubuntu 24.04 LTS or Linux Mint 21.3
- Upgrading to MySQL 8.x