Creavix Retail POS & Multi-Store Inventory Docs
Comprehensive installation, server setup, database provisioning, and ecosystem extension reference.
1. Overview & Architecture
Creavix Retail POS & Multi-Store Inventory is built upon modern Laravel architecture, utilizing domain-driven service layers, clean repository patterns, and unencrypted modular components. The system operates seamlessly on both cloud virtual private servers (VPS) and isolated local network intranet environments (LAN).
Laravel 11 / 12
Blade, TailwindCSS, Alpine.js
MySQL 8.0+ / MariaDB 10.5+
2. Server Requirements
Ensure your hosting environment or on-premise server meets the following verified prerequisites:
| Requirement | Recommended Version | Details |
|---|---|---|
| PHP | PHP 8.2 or 8.3 | bcmath, ctype, curl, fileinfo, mbstring, openssl, pdo_mysql, tokenizer, xml, gd/imagick |
| Web Server | Nginx 1.20+ or Apache 2.4+ | mod_rewrite enabled; root pointing to /public directory |
| Database Engine | MySQL 8.0+ / MariaDB 10.6+ | utf8mb4 charset and utf8mb4_unicode_ci collation |
| Hardware Sizing | 2 vCPU, 2GB+ RAM, 20GB SSD | Scalable according to concurrent hospital/retail staff users |
3. Step-by-Step Installation
Extract your licensed package into your web server directory and follow the standard deployment sequence:
# 1. Unpack source into project root and cd
$ cd /var/www/pos-software
# 2. Install production PHP packages
$ composer install --no-dev --optimize-autoloader
# 3. Create environment config file and generate encryption key
$ cp .env.example .env
$ php artisan key:generate
# 4. Migrate database schema and seed default administrative account
$ php artisan migrate --seed --force
# 5. Create storage symlink for uploaded files
$ php artisan storage:link
# 6. Set correct write permissions for web server
$ chown -R www-data:www-data storage bootstrap/cache
$ chmod -R 775 storage bootstrap/cache
4. Environment Configuration (.env)
Configure your database credentials, system URL, and notification mailer in your .env file:
APP_NAME="Creavix Retail POS & Multi-Store Inventory"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://your-domain.com
# Database Connection
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pos_software_db
DB_USERNAME=db_user
DB_PASSWORD=your_secure_password
5. Scheduled Tasks & Queues
To enable automated reminder emails, recurring invoices, and background data synchronization, add the Laravel cron entry:
* * * * * cd /var/www/pos-software && php artisan schedule:run >> /dev/null 2>&1
6. Installing Compatible Add-ons
Creavix modular add-ons plug directly into Creavix Retail POS & Multi-Store Inventory without modifying core framework files:
7. Troubleshooting & Engineering Support
Encountering an issue? Check your logs in storage/logs/laravel.log. For verified technical assistance, direct questions to our engineering office:
Direct Engineering Support Desk
Available Monday through Saturday for licensed customers.