Docs / Requirements

System Requirements

This application is built on Laravel 12. Use this checklist to verify your hosting/server supports everything needed for a smooth installation and stable production use. These checks are automatically performed by the installer on first-time setup.

Important: The app works on both VPS and shared hosting. Queue is supported with Database and Sync modes where needed. If your shared hosting restricts Artisan commands, you can still install by manually importing the database and creating/updating the .env file.

Quick Install

Run the installer wizard and verify server checks.

Troubleshooting

Fix permissions, extensions, and hosting limitations.

Installer Automatic Checks

During installation, the system runs a built-in routine to confirm your server is ready. It validates PHP version, required PHP extensions, folder permissions, and environment readiness (.env / .env.example + write access).

PHP Version Check
Minimum validated by installer: PHP 8.1.0+
Recommended: PHP 8.2 / 8.3 for best Laravel 12 stability.

Hard-Fail vs Soft-Fail
Installer hard-fails if core extensions/permissions are missing.
.env not writable is treated as soft-fail (you can do it manually).

Folders Checked
storage/, bootstrap/cache, plus recommended framework folders like storage/framework/* and storage/logs.

Checklist Summary

Category	Installer Checks	Notes
PHP	PHP version >= `8.1.0`	Recommended: `8.2+`
Extensions	`openssl`, `pdo`, `mbstring`, `tokenizer`, `xml`, `ctype`, `json`, `bcmath`, `fileinfo`	Missing extensions can cause install/runtime errors.
Core Permissions	`storage/` writable `bootstrap/cache` writable	Treated as hard requirements.
Recommended	`storage/framework/cache` `storage/framework/sessions` `storage/framework/views` `storage/logs`	Laravel will create folders if base permissions allow.
Environment	`.env` exists (or will be created) `.env.example` exists (recommended) Write access to update/create `.env`	If `.env` is not writable, complete setup manually on restricted hosting.

Where these checks run: Installer step "Requirements / Server Check". If something fails, take a screenshot and share it with support.

Minimum Server

Server & Database

PHP: 8.2+ recommended (installer validates minimum 8.1.0)
Database: MySQL 8+ recommended (MariaDB supported)
Web Server: Apache or Nginx
HTTPS: Strongly recommended for login + sessions

Tip: Prefer VPS for best performance and fewer hosting limitations.

PHP Extensions (Required)

OpenSSL
PDO
Mbstring
Tokenizer
XML
Ctype
JSON
BCMath
Fileinfo

Missing extensions can cause: validation issues, encryption errors, file uploads failing, and "class not found" problems.

Filesystem & Permissions

Required Writable Folders

storage/ must be writable
bootstrap/cache must be writable
Recommended: storage/framework/cache, storage/framework/sessions, storage/framework/views, storage/logs

On Linux, typical permission fix:

chmod -R 775 storage bootstrap/cache

Environment Files (.env)

.env should exist (installer may create/update it)
.env.example is recommended to ship with the app
Write access needed to update/create .env

On restricted shared hosting, you may need to manually upload/edit .env.

Recommended Services

Performance & Reliability

Queue: Database (minimum) / Redis (recommended)
Cache: File (minimum) / Redis (recommended)
Email: SMTP recommended (Mailtrap for testing)
Cron: Required for scheduled tasks (if enabled)

If you enable scheduled publishing/automation later, cron becomes mandatory.

Browser Support

Chrome, Edge, Firefox - latest 2 versions
Safari - latest version (macOS/iOS)

Tip: For best admin experience, use Chrome/Edge latest.

Optional (If Enabled)

2FA (TOTP): Requires correct server time (NTP). If time is wrong, codes fail.

PDF Invoices: Ensure your PDF library requirements are met (fonts, GD/Imagick if used).