Skip to content

Ubuntu 24.04 LTS, 22.04 LTS, or Linux Mint 21.3 Cinnamon Installation

Bones edited this page May 1, 2024 · 2 revisions

Setting Up OSPOS Release 3.3.9

Start with a fresh and clean install of either Linux Mint 21.3, Ubuntu 24.04 LTS, or Ubuntu 22.04.4 LTS.

Install the LAMP stack with the following commands in the terminal window:

sudo add-apt-repository ppa:ondrej/php

sudo apt update

sudo apt-get install -y apache2 mariadb-server php7.4 php7.4-curl php7.4-mysql php7.4-gd php7.4-intl php7.4-bcmath php7.4-mbstring php7.4-xml php7.4-mysqli

sudo a2enmod rewrite

sudo phpenmod intl gd bcmath curl

Edit the apache2.conf file with:

sudo nano /etc/apache2/apache2.conf

Modify the following section to set AllowOveride to All:

<Directory /var/www/>
	Options Indexes FollowSymLinks 
	AllowOverride All 
	Require all granted 
</Directory>

Reboot apache2:

sudo systemctl restart apache2

Remove the default index.html file:

sudo rm /var/www/html/index.html

Create the OSPOS user and database:

sudo mysql -u root -e "CREATE SCHEMA ospos;CREATE USER 'admin'@'%' IDENTIFIED BY 'pointofsale';GRANT ALL PRIVILEGES ON ospos.* TO 'admin'@'%';FLUSH PRIVILEGES;"

Download V3.3.9 of OSPOS from the releases section @ https://github.com/opensourcepos/opensourcepos/releases/tag/3.3.9

Put the V3.3.9 zip file in your Downloads folder then rename it to ospos.zip

Unzip all the files from the release zip file to /var/www/html/ folder.

sudo unzip ~/Downloads/ospos.zip -d /var/www/html/

Set file ownership:

sudo chown -R www-data:www-data /var/www/html

Load the database:

mysql -u admin -ppointofsale -D ospos < /var/www/html/database/database.sql

Open your browser and go to http://localhost/public

Login as admin with password pointofsale

This should upgrade the database and redirect you to log in again.

Login again as before and system should be operational.

Close your browser and secure the web folders:

sudo chmod 750 /var/www/html/application/logs

sudo chmod 750 /var/www/html/public/uploads

sudo chmod 750 /var/www/html/public/uploads/item_pics

sudo chmod 640 /var/www/html/import_customers.csv

Proceed to add Postfix if you need email service:

https://github.com/opensourcepos/opensourcepos/wiki/Setting-Up-OSPOS-with-Postfix-and-Gmail-SMTP-Server

Clone this wiki locally