LaraVue POS - Complete Documentation

Why Choose LaraVue POS?

A comprehensive business management solution trusted by medium to large-scale traders and retailers worldwide

Inventory Management

Complete control over inventory, categories, units, brands, and item management with real-time tracking.

Sales & Purchases

Streamlined purchase and sales processes with warranty handling and comprehensive transaction management.

User Management

Advanced user roles and permissions system to control access and maintain security across your organization.

Payment Methods

Support for multiple payment methods including credit, debit, cash, and custom payment options.

Reports & Analytics

Comprehensive reporting system with analytics to help you make informed business decisions.

Business Settings

Flexible tax rate configuration and business settings to adapt to your specific requirements.

System Requirements

Ensure your server meets these requirements for optimal performance

Server Requirements

PHP Version	^7.3.5 \| ^8.0
Laravel Version	8.x
Vue.js Version	2.6.11
Database	MySQL 8.0

PHP Extensions

OpenSSL
PDO
Mbstring
Tokenizer
XML, cURL, Zip, GD

Installation Guide

Step-by-step installation process for both local and live server environments

Step 1: Download & Extract

Extract the LaraVue POS package to your local server directory:

XAMPP: htdocs/
Laragon: www/
WAMP: www/

Step 2: Create Database

Create a new MySQL database using phpMyAdmin or your preferred database management tool.

Step 3: Configure Environment

cp .env.example .env

Update database credentials in .env:

DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

Step 4: Install Dependencies

composer install
npm install
npm run prod

Step 5: Generate Application Key

php artisan key:generate

Step 6: Run Migrations

php artisan migrate --seed

Step 7: Set Permissions

chmod -R 775 storage
chmod -R 775 bootstrap/cache

Step 8: Start Application

php artisan serve

Visit http://localhost:8000 to access LaraVue POS.

After installation, access the setup interface to complete your configuration:

Local: http://localhost/install

1. System Check

Verifies server requirements and permissions

2. Environment Configuration

Choose between Form Wizard or Manual Editor

3. Business Setup

Configure business details, currency, timezone

4. Admin User & Dashboard

Create administrator account and access POS system

Step 1: File Upload

Extract LaraVue POS package locally
Upload all files to public_html or subdirectory via FTP

Step 2: Environment Configuration

Rename .env.example to .env and update with live server credentials:

APP_NAME=LaraVuePOS
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_db_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

Step 3: Dependencies

For Shared Hosting:

Run composer install and npm install && npm run prod locally
Upload vendor/ and built assets to server

For VPS/SSH Access:

cd /path-to-your-project
composer install
npm install
npm run prod
php artisan key:generate
php artisan migrate

Step 4: Final Steps

chmod -R 775 storage
chmod -R 775 bootstrap/cache

Visit https://yourdomain.com and follow the setup wizard.

Step 1: Copy Environment File

Copy the Docker-specific environment file:

cp docker/.env.docker .env

If you want to change the application port, you can modify it in the .env file.

Step 2: Build & Run with Docker

Run the following command to build and start your containers:

docker compose up --build -d

Please wait for a while. This process may take some time depending on your system performance and network speed.

Step 3: Access the Application

Your application will be running at:

http://localhost:8084

Professional Installation Service

Need extra help? We offer remote installation assistance via Zoom or AnyDesk for seamless setup and configuration.

Contact us for professional remote installation support

Troubleshooting

Common issues and their solutions to help you get up and running quickly

White Screen/Blank Page

Cause: Missing dependencies or PHP errors

Solution: Set APP_DEBUG=true, run composer install

404 Not Found

Cause: Server root misconfiguration

Solution: Point server to /public folder, enable mod_rewrite

Class Not Found

Cause: Missing vendor folder

Solution: Run composer install

Database Connection Error

Cause: Incorrect credentials

Solution: Verify .env database settings

Missing Encryption Key

Cause: Key not generated

Solution: Run php artisan key:generate

Permission Denied

Cause: Insufficient folder permissions

Solution: Set proper permissions on storage directories

Directory Structure

Understanding the project file organization

laravue-pos/
├── app/ # Application logic
├── bootstrap/ # Bootstrap files
├── config/ # Configuration files
├── database/ # Migrations and seeders
├── docker/ # Docker
├── documentation/ # Documentation
├── public/ # Public assets and entry point
├── resources/ # Views, Vue components, assets
├── routes/ # Route definitions
├── storage/ # Storage and cache
├── vendor/ # Composer dependencies
├── .env.example # Environment template
├── composer.json # PHP dependencies
└── package.json # Node.js dependencies

Technical Support

Get help when you need it from our experienced support team

Email Support

Get detailed technical assistance via email

support@hashmanagement.com

WhatsApp Support

Quick support via WhatsApp messaging

+1-2015274802

Facebook

Connect with us on social media

Hash Management

Website

Visit our website for more information

hashmanagement.com