Documentation – DevMantis | Installation & Setup Guides

⚙️ System Requirements

Requirement	Minimum	Recommended
PHP Version	7.4+	8.1 or 8.2
MySQL	5.7+	8.0+ / MariaDB 10.6+
Web Server	Apache 2.4+	Nginx 1.20+ or Apache
RAM	512 MB	1 GB+
Storage	50 MB	500 MB+ (for uploads/logs)
PHP Extensions	PDO, PDO_MySQL, cURL, mbstring, openssl, fileinfo, gd

🚀 Installation Guide

Follow these steps to install any DevMantis product on your server. The process is the same for all products.

1

Download the Product Files

Log in to your CodeCanyon account or DevMantis dashboard and download the ZIP file. Extract it on your local machine.

2

Create a Database

Using phpMyAdmin or your hosting control panel, create a new MySQL database and user. Grant all privileges to the user on this database.

Then import the SQL file found in the database/ folder of the product.

3

Upload Files to Your Server

Upload all product files to your web server's public directory (public_html, www, or a subdomain folder).

4

Configure Database Connection

Open config/database.php and update your database credentials:

// config/database.php
<?php
define('DB_HOST', 'localhost');
define('DB_NAME', 'your_database_name');
define('DB_USER', 'your_db_user');
define('DB_PASS', 'your_db_password');
define('APP_URL',  'https://yourdomain.com');
?>

5

Set File Permissions

Ensure the following directories are writable by the web server:

chmod 755 storage/
chmod 755 uploads/
chmod 644 config/database.php

6

Open in Browser & Log In

Visit your domain in a browser. Access the admin panel at /admin with the default credentials from the README file. Change your password immediately.

💡

Default admin credentials are listed in the README.txt file included with your download. Always change them before going live.

📋 Configuration Reference

Application Settings

// config/app.php
define('APP_NAME',     'Your Company Name');
define('APP_URL',      'https://yourdomain.com');
define('APP_DEBUG',    false);          // Set false in production
define('APP_TIMEZONE', 'Africa/Lagos'); // Set your timezone
define('APP_CURRENCY',  'NGN');         // Currency code
define('CURRENCY_SYM',  '₦');          // Currency symbol

Email (SMTP) Configuration

// config/mail.php
define('MAIL_HOST',       'smtp.gmail.com');
define('MAIL_PORT',       587);
define('MAIL_USERNAME',   'your@email.com');
define('MAIL_PASSWORD',   'your_app_password');
define('MAIL_ENCRYPTION', 'tls');
define('MAIL_FROM_NAME',  'Your App Name');

⚠️

Never commit real credentials to version control. Use environment variables or a separate .env file that is excluded from git.

🔑 License Activation

Your license key was emailed to you after purchase and is also available in your CodeCanyon Downloads page.

Log in to the admin panel at /admin
Go to Settings → License
Paste your license key in the provided field
Click Activate
Your installation is now activated — no expiry for perpetual licenses

💡

Regular licenses activate for one domain. Extended licenses can be activated on multiple domains. If you need to transfer a license, contact support.

License Types Summary

License	Deployments	SaaS/Resale	Support	Updates
Regular	1 project	Not permitted	6 months	Free, lifetime
Extended	Multiple	Permitted	12 months	Free, lifetime
Enterprise	Unlimited	Permitted + white-label	Custom SLA	Free, lifetime

🔄 Updating to a New Version

⚠️

Always back up your database and files before updating. This prevents any data loss if something unexpected occurs during the update process.

Download the latest version from your CodeCanyon account or the DevMantis website
Back up your current files and database
Read the CHANGELOG.txt included in the download for any breaking changes
Upload the new files, overwriting existing ones (do not overwrite your config/ folder)
If the changelog mentions a database update, run the provided SQL migration script via phpMyAdmin
Clear your browser cache and test the application

🚚 Logistics Tracking — Quick Setup

After completing the standard installation, follow these steps specific to the Logistics Tracking System:

Configure Shipment Statuses

Go to Admin → Settings → Shipment Statuses to customize the tracking stages for your workflow (e.g. Pending, Picked Up, In Transit, Delivered).

Add Drivers

Navigate to Admin → Drivers → Add New Driver. Each driver gets a login and can update shipment status from their mobile browser or the driver portal.

Create Your First Shipment

// Shipment tracking number format (auto-generated)
DM-2025-{RANDOM_8_DIGITS}
// Example: DM-2025-48291037

A QR code and barcode are automatically generated for each shipment. Print these on waybills or packaging for barcode scanner compatibility.

🏦 Online Banking — Quick Setup

After installation, configure the core banking settings before opening the system to users.

Set Bank Details

Go to Admin → Settings → Bank Profile and fill in your institution name, logo, contact details, and SWIFT/sort code if applicable.

Configure Account Types

Navigate to Admin → Account Types to set up Savings, Current, and any other account types relevant to your institution. Each type can have its own interest rate, minimum balance, and transaction limits.

Create the First Customer Account

Go to Admin → Customers → Add New
Fill in personal details and select an account type
The system auto-generates an account number
Set an initial deposit amount (can be zero)
Customer receives login credentials via email

❓ Troubleshooting & FAQ

Enable PHP error display temporarily by adding error_reporting(E_ALL); ini_set('display_errors', 1); to the top of index.php. Check the error, resolve it, then remove this line before going live.

This usually means Apache's mod_rewrite is not enabled. Contact your hosting provider to enable it, or add AllowOverride All to your virtual host configuration. If you're on Nginx, ensure the included nginx.conf rules are applied.

Check your SMTP configuration in config/mail.php. For Gmail, use an App Password (not your regular password) and ensure 2FA is enabled. Many shared hosts also block outbound SMTP on port 587 — try port 465 with SSL, or use your host's built-in SMTP server.

If the SQL file is large, phpMyAdmin may time out. Try importing via the MySQL command line: mysql -u username -p database_name < database/schema.sql. Alternatively, increase the max_execution_time in your PHP settings.

Run this SQL query in phpMyAdmin, replacing the hash with a bcrypt hash of your new password:
UPDATE users SET password = 'NEW_BCRYPT_HASH' WHERE role = 'admin' LIMIT 1;
Use bcrypt-generator.com to generate the hash.

Product Documentation

Quick Start

Requirements

License Activation

Configuration

Updates

FAQ