Server requirements
- PHP 8.x + MySQL / MariaDB
- Apache/Nginx with document root pointing to
public/ - Config in
app/config/config_local.php(or production)
Install steps
-
Clone or copy the project to e.g.
htdocs/mstock -
Create database named
mstock, then run core migrations fromapp/database/migrations/ -
Recommended migrations (in order) via phpMyAdmin or CLI:
RUN_notification_telegram_tables.sql2026_06_01_000052_notification_audit_log_channel.sql2026_05_24_000053_settings_complete_and_fix_types.sqlRUN_documents_phase1_columns.sql→ then 000001, 000002, 000005 (documents)
-
Open the app
http://localhost/mstock/public/and log in with seed user -
Configure company, documents, POS, branches at
/admin/settings
Go-live checklist
- Enforce branch/user limits (license or settings)
- Deliver this guide + standard migrations to the customer
- Do not promote Tasks/Kanban until routes exist
- VAT document forms per shop standard (if selling to VAT shops)