Ubuntu 24.04 LTS, 22.04 LTS, or Linux Mint 21.3 Cinnamon Installation
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:
- 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