Posify POS
Complete Laravel-powered Point of Sale system for retail and food businesses — POS terminal, inventory, suppliers, purchase orders, cash register shifts, customer loyalty, expense tracking, and reports.
Introduction
Posify POS is a complete, single-application Point of Sale system built on Laravel 12. It covers every aspect of a retail or food business:
POS Terminal
Barcode scanning, split payments, thermal receipts, and cash register shifts.
Inventory & Purchasing
Products, variants, warehouses, suppliers, and purchase orders with stock receiving.
Reports & Admin
Sales, P&L, inventory valuation, expense, and product reports — all CSV exportable.
Everything runs as one Laravel application — no separate frontend server or mobile app required. Follow this documentation to install and configure Posify POS on your server.
System Architecture
Posify POS is a monolithic Laravel application — one codebase, one deployment. Livewire handles reactive UI components server-side, so no separate JS build server is needed in production.
What's Included
- ✓ Laravel 12 full source code
- ✓ Web installer wizard
- ✓ Pre-seeded demo data (optional)
- ✓ Documentation
Tech Stack
- • PHP 8.2+ / Laravel 12
- • Livewire 3 / Alpine.js
- • Tailwind CSS v4
- • MySQL 5.7+ / MariaDB
- • JsBarcode (barcode labels)
Changelog
- ✓ POS terminal — products, inventory, orders, payments
- ✓ Customers, users, roles & permissions
- ✓ Multi-language, settings, REST API
- ✓ Web installer — browser-based multi-step setup wizard (requirements, purchase verification, database, admin, finish)
- ✓ Suppliers & Purchase Orders — supplier CRUD, PO with line items, stock receiving into inventory, supplier payments
- ✓ Cash register / shifts — open & close register sessions, cash in/out movements, printable Z-Report
- ✓ Returns & refunds — return items against an order with optional restock; payment status reflects partial/full refunds
- ✓ Customer accounts — due/credit ledger, loyalty points (earn on sale, redeem for value), per-customer ledger view
- ✓ Expense management — expense categories and expenses with date filtering
- ✓ Reports — Sales, Product, Category, Profit & Loss, Inventory Valuation, and Expense reports — each exportable to CSV
- ✓ Thermal receipts — 80mm / 58mm auto-printing alongside the existing A4 PDF invoice
- ✓ Barcode in POS — scan-to-search in the POS terminal, plus printable barcode label sheet (JsBarcode)
- ✓ Database backup & restore — admin-initiated SQL dump/restore (no shell access required)
- ✓ QR code menu — QR generation for products (menu-item scanning)
- ✓ Loyalty settings — added to General Settings
Server Requirements (VPS)
Minimum recommended specs for running Posify POS (Laravel + MySQL) on a VPS.
CPU
1 vCPU minimum. 2 vCPUs recommended for production.
RAM
1 GB minimum. 2 GB recommended.
OS
Ubuntu 22.04 LTS (recommended) or Debian 12.
Important Server Documentation
Follow these notes when the application shows a server error.
500 Internal Server Error — Common Fix
The most common cause is a missing .env file or missing Laravel app key:
Then update .env with your database credentials before continuing.
Storage Permissions
File uploads and cache will fail if storage folder permissions are wrong:
Install & Configure Nginx
1. Install Nginx
sudo apt update
sudo apt install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx2. Virtual host — /etc/nginx/sites-available/yourdomain.com
server {
listen 80;
server_name yourdomain.com www.yourdomain.com;
root /var/www/posify-pos/public;
index index.php;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
}
location ~ /\.ht { deny all; }
}3. Enable site & reload
sudo ln -s /etc/nginx/sites-available/yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxInstall & Configure MySQL
1. Install MySQL 8
sudo apt install -y mysql-server
sudo systemctl enable mysql
sudo mysql_secure_installation2. Create database & user
sudo mysql -u root -p
CREATE DATABASE posify CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'posify_user'@'localhost' IDENTIFIED BY 'StrongPassword!';
GRANT ALL PRIVILEGES ON posify.* TO 'posify_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;3. Update Laravel .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=posify
DB_USERNAME=posify_user
DB_PASSWORD=StrongPassword!Install PHP & Extensions
Posify POS requires PHP 8.2 or higher. The commands below install PHP 8.3 (recommended) with all required extensions.
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install -y php8.3 php8.3-fpm php8.3-mysql php8.3-mbstring \
php8.3-xml php8.3-bcmath php8.3-curl php8.3-zip php8.3-gd php8.3-intl
sudo systemctl enable php8.3-fpm
sudo systemctl start php8.3-fpmphp -v should show PHP 8.3.x
Install Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --versionThen inside your project directory:
cd /var/www/posify-pos
composer install --optimize-autoloader --no-devDomain & DNS Configuration
Point your domain to the VPS IP via your registrar's DNS panel.
| Type | Name / Host | Value | TTL |
|---|---|---|---|
| A | @ | YOUR_VPS_IP | Auto |
| A | www | YOUR_VPS_IP | Auto |
dig yourdomain.com.
SSL Setup with Certbot (HTTPS)
1. Install Certbot
sudo apt install -y certbot python3-certbot-nginx2. Obtain certificate
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com3. Verify & test auto-renewal
sudo nginx -t && sudo systemctl reload nginx
sudo certbot renew --dry-runAPP_URL=https://yourdomain.com in your Laravel .env and clear cache: php artisan config:clear
Shared Hosting Requirements
Confirm your cPanel environment supports the following before deploying.
Laravel / Posify POS
- ✓ PHP 8.2+ via MultiPHP or PHP Selector
- ✓ MySQL 5.7+ or MariaDB
- ✓ Composer (SSH Terminal)
- ✓ SSH Terminal access (cPanel → Terminal)
- ✓ Addon Domain / Subdomain creation
- ✓ File Manager or FTP access
- ✓ AutoSSL / Let's Encrypt SSL
Laravel Setup on cPanel
Deploy Posify POS on shared hosting step by step.
Create Domain & Point to public/
In cPanel → Domains, add your domain and set its Document Root to the project's public/ folder:
/home/yourusername/posify-pos/public
Upload Project Files
Upload the ZIP via cPanel → File Manager then extract:
cd ~/posify-pos unzip posify-pos.zip -d . rm posify-pos.zip
Set PHP Version to 8.2+
In cPanel → MultiPHP Manager (or PHP Selector), select your domain and set PHP to 8.2 or newer. Enable extensions: pdo_mysql mbstring xml curl zip gd bcmath fileinfo.
Create MySQL Database
cPanel → MySQL Databases:
- Create database:
yourusername_posify - Create user with a strong password
- Add user to database with All Privileges
Configure .env
Rename .env.example → .env and edit:
# App APP_NAME="Posify POS" APP_ENV=production APP_DEBUG=false APP_URL=https://yourdomain.com # Database DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=yourusername_posify DB_USERNAME=yourusername_dbuser DB_PASSWORD=StrongPassword! # Mail (optional) MAIL_MAILER=smtp MAIL_HOST=mail.yourdomain.com MAIL_PORT=587 MAIL_USERNAME=no-reply@yourdomain.com MAIL_PASSWORD=your_email_password MAIL_FROM_ADDRESS=no-reply@yourdomain.com
Install Composer & Run Artisan
cd ~/posify-pos curl -sS https://getcomposer.org/installer | php php composer.phar install --optimize-autoloader --no-dev php artisan key:generate php artisan migrate --force php artisan db:seed --force php artisan storage:link php artisan optimize
Set Permissions & Enable SSL
chmod -R 755 storage bootstrap/cache
Enable SSL via cPanel → SSL/TLS → AutoSSL or Let's Encrypt.
Test the Installation
Visit your domain — you should see the login page:
Server Requirements
Verify your hosting environment before installation.
PHP & Extensions
- ✓ PHP 8.2 or higher
- ✓ OpenSSL
- ✓ PDO + PDO_MySQL Extension
- ✓ Mbstring Extension
- ✓ Tokenizer Extension
- ✓ XML Extension
- ✓ Ctype Extension
- ✓ cURL Extension
- ✓ JSON Extension
- ✓ BCMath Extension
- ✓ Fileinfo Extension
- ✓ ZIP Extension
- ✓ GD Extension
Database & Server
- ✓ MySQL 5.7+ or MariaDB
- ✓ Composer 2.x
- ✓ Apache or Nginx
- ✓ SSL Certificate (HTTPS)
- ✓ 512MB+ RAM
Installation Guide
Deploy Posify POS on your VPS. You can use the web installer (no SSH needed for setup) or install manually via SSH.
Download from Envato
Log in to CodeCanyon → Downloads → Posify POS → Download All Files & Documentation. Extract the ZIP.
Upload Project to Server
Option A — SCP / FTP
scp posify-pos.zip user@YOUR_VPS_IP:/var/www/ ssh user@YOUR_VPS_IP cd /var/www && unzip posify-pos.zip -d posify-pos
Option B — Git
sudo mkdir -p /var/www/posify-pos cd /var/www/posify-pos sudo git clone https://github.com/your-repo/posify-pos.git .
Configure .env & Choose Install Method
Copy .env.example → .env, then visit the installer in your browser and follow the on-screen steps — no SSH needed for the rest of the setup:
Installer Steps Preview
Copy and edit .env via SSH, then run artisan commands:
cd /var/www/posify-pos cp .env.example .env nano .env # set APP_URL, DB_* values composer install --optimize-autoloader --no-dev php artisan key:generate php artisan migrate --force php artisan db:seed --force php artisan storage:link php artisan optimize
Set Folder Permissions
chmod -R 775 storage bootstrap/cache chown -R www-data:www-data storage bootstrap/cache
Test the Installation
Open your browser and visit the admin panel — you should see the login page.
Before going live, verify:
APP_DEBUG=false- Storage symlink exists:
ls -la public/storage - Folder permissions set on
storage/andbootstrap/cache/ - SSL certificate active
Configuration
Key settings available from Admin → Settings after installation.
General Settings
- • Store name, logo, currency, timezone
- • Tax rate and tax name
- • Loyalty points rate (earn per sale amount) and redemption rate
- • Receipt header / footer text
- • Default language
Thermal Receipt Printer
Configure from Settings → Receipt Settings. Choose paper width (80mm or 58mm) and enable auto-print after POS sale.
Mail (SMTP)
Set in your .env file:
MAIL_MAILER=smtp MAIL_HOST=smtp.mailtrap.io MAIL_PORT=587 MAIL_USERNAME=your_username MAIL_PASSWORD=your_password MAIL_FROM_ADDRESS=no-reply@yourdomain.com MAIL_FROM_NAME="Posify POS"
Queue Worker & Background Jobs
Posify POS ships with QUEUE_CONNECTION=sync in .env — emails and notifications are sent immediately during the request, so everything works out of the box with no worker process and no extra setup.
sync.
1. Enable background sending
Set the queue driver to database in your .env, then clear the config cache:
QUEUE_CONNECTION=database
php artisan config:clear
Queued jobs are now stored in the database — but they only run while a queue worker is running. Pick one of the options below.
2a. Recommended (VPS): Supervisor
Supervisor keeps the worker alive permanently and restarts it if it crashes:
sudo apt install -y supervisor sudo nano /etc/supervisor/conf.d/posify-worker.conf
[program:posify-worker] process_name=%(program_name)s_%(process_num)02d command=php /var/www/posify-pos/artisan queue:work database --sleep=3 --tries=3 --max-time=3600 autostart=true autorestart=true stopasgroup=true killasgroup=true user=www-data numprocs=1 redirect_stderr=true stdout_logfile=/var/www/posify-pos/storage/logs/worker.log stopwaitsecs=3600
sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl start posify-worker:*
2b. Fallback (shared hosting): Cron
No Supervisor on shared hosting? Add a cron job (cPanel → Cron Jobs) that drains the queue every minute and exits when it's empty:
* * * * * php /home/yourusername/posify-pos/artisan queue:work --stop-when-empty
Adjust the path to your installation. Emails may be delayed by up to a minute — acceptable for most stores.
sudo supervisorctl restart posify-worker:* or php artisan queue:restart) so it picks up the new code.
Features
All modules available in Posify POS v1.0.0.
Dashboard
Real-time overview of store performance — today's revenue, orders, top products, and low-stock alerts.
- ✓ Daily, weekly, and monthly revenue charts
- ✓ Total orders and top-selling products
- ✓ Low-stock product alerts
- ✓ Recent order activity feed
POS Terminal
Fast checkout screen with barcode scan-to-add, split payments, discounts, and instant thermal receipt printing.
- ✓ Barcode scan-to-search (USB/Bluetooth scanner)
- ✓ Cash, card, and split payment support
- ✓ 80mm / 58mm thermal receipt + A4 PDF
- ✓ Redeem customer loyalty points at checkout
- ✓ Orders sync with inventory automatically
Products & Inventory
Full product catalog with categories, brands, units, variants, and warehouse-level stock tracking.
- ✓ Products with variants, addons, and images
- ✓ Categories, brands, and units of measure
- ✓ Per-warehouse stock levels and movements
- ✓ Stock transfers between warehouses
- ✓ Printable barcode label sheets (JsBarcode)
Suppliers & Purchase Orders
Manage supplier relationships and purchase orders from order creation through stock receiving.
- ✓ Supplier CRUD with contact details
- ✓ Purchase orders with line items and costs
- ✓ Receive stock into inventory from POs
- ✓ Track supplier payments and balances
Cash Register & Returns
Full shift management with Z-Reports and a complete returns/refund flow with restock option.
- ✓ Open/close register sessions with opening cash
- ✓ Cash in/out movements during shift
- ✓ Printable Z-Report on close
- ✓ Return items against an order (with optional restock)
- ✓ Payment status auto-updates to partial/full refund
Roles & Permissions
Fine-grained role-based access control — define exactly what each staff member can see and do.
- ✓ Unlimited custom roles (cashier, manager, admin)
- ✓ Toggle individual permissions per role
- ✓ Assign multiple roles to one user
- ✓ Activity log of all admin actions
Settings & Utilities
Store settings, multi-language management, database backup/restore, and more — all from the admin panel.
- ✓ Store info, currency, tax, and receipt settings
- ✓ Loyalty points earn/redeem rates
- ✓ Multi-language with admin-editable translations
- ✓ Database backup & restore (no shell needed)
Third-Party Licenses
Posify POS bundles open-source libraries. Most use permissive MIT/BSD-style licenses; one exception to be aware of:
vendor/mpdf/mpdf/ after composer install.
The full list of bundled third-party libraries and their licenses is in credits.txt in the application root.