Minimum Server Requirements

• PHP >= 8.2 (8.3+ preferred)
• MySQL >= 8.0 or MariaDB >= 10.10
• Apache >= 2.4 or Nginx >= 1.15 (Recommended: 1.20+ (LTS))
• Memory Limit >= 1 GB (Recommended: 2 GB+)
• Max Execution Time >= 300 seconds
• Disk Space >= 10 GB (Recommended: 20 GB+)

Required PHP Extensions

• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension
• cURL Extension
• JSON Extension
• XML PHP Extension
• BCMath PHP Extension
• Ctype PHP Extension
• Fileinfo PHP Extension
• DOM PHP Extension
• GD PHP Extension (or Imagick)
• ZIP PHP Extension
• Exif PHP Extension
• mysqli PHP Extension
• pdo_mysql (for MySQL/MariaDB)

Required PHP Settings

allow_url_fopen = On
file_uploads = On
max_file_uploads = 20
upload_max_filesize = 32M
post_max_size = 32M
max_input_vars = 3000
max_execution_time = 300
memory_limit = 200M

Database Requirements

• MySQL 8+ or MariaDB 10.10+
• InnoDB storage engine support
• UTF8MB4 character set support
• Database user with full privileges

Web Server Configuration

• URL Rewrite Module enabled
• HTTPS support (recommended)
• Gzip compression enabled (recommended)
• Security headers configured (recommended)

Required Writable Permissions (777)

• /lang — Language files

Required Writable Permissions (775) [If you face permission errors try 777]

• /storage — Application logs, cache, and temporary files
• /storage/app — Application file storage
• /storage/framework — Framework cache and session files
• /storage/logs — Application log files
• /bootstrap/cache — Bootstrap cache files
• /vendor — Vendor files

Required File Permissions (664) [If you face permission errors try 666]

• .env — Environment configuration file
• modules_statuses.json — Modules configuration file

Creating DB in cPanel

Step 1: Create Database

1. Login to your cPanel dashboard
2. Navigate to Manage My Databases section
3. Under Create New Database, enter database name (e.g., yourdb_your_db_name)
4. Click Create Database

Goto the Manage My Databases from cPanel

Create New Database

×

Step 2: Create Database User

1. Scroll down to MySQL Users section
2. Enter username (e.g., yourdb_your_db_user_name)
3. Enter a strong password (avoid # character)
4. Click Create User

Add New User

Step 3: Add User to Database

1. In Add User to Database section
2. Select the user you created
3. Select the database you created
4. Click Add
5. Check ALL PRIVILEGES and click Make Changes

Add User To Database

Universal / Other Servers

CREATE DATABASE `yourdb` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'youruser'@'%' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON `yourdb`.* TO 'youruser'@'%';
FLUSH PRIVILEGES;

Queues: Start a Worker

Use one of the following options to run the queue worker continuously.

Option A — Terminal (Linux/macOS)

php artisan queue:work

Recommended to run under a process manager (Supervisor/systemd) so it restarts automatically.

Supervisor (Linux)

# /etc/supervisor/conf.d/trustedhrm-queue.conf
[program:trustedhrm-queue]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/your/project/artisan queue:work
autostart=true
autorestart=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/log/supervisor/trustedhrm-queue.log

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start trustedhrm-queue:*

Option B — Windows (Task Scheduler)

1. Open Task Scheduler → Create Task
2. Action: Start a Program
3. Program/script: php
4. Add arguments: artisan queue:work
5. Start in: C:\\path\\to\\your\\project
6. Trigger: At startup or on logon; set to run whether user is logged on or not

Option C — Shared Hosting (cPanel)

Create a Cron Job with the following command (runs the worker in the background):

cd /home/USERNAME/public_html && php artisan queue:work > /dev/null 2>&1 &

Note: Replace /home/USERNAME/public_html with your project path.

Scheduler: Run Cron

Laravel's scheduler should be triggered every minute to run due tasks (emails, cleanups, reminders, etc.).

Linux Cron

* * * * * php /path/to/your/project/artisan schedule:run > /dev/null 2>&1

cPanel Cron

1. cPanel → Cron Jobs → Add New Cron Job
2. Common Settings: Once Per Minute
3. Command:

php /home/USERNAME/public_html/artisan schedule:run > /dev/null 2>&1

Troubleshooting

What you can configure

• Date Format: (e.g., DD/MM/YYYY)
• Time Format: (e.g., 12-hour AM/PM)
• Fiscal Year: Your employee's leave will be reset based on this fiscal year. (e.g., If you choose January - December. Then on January all employees leave will be reset)
• Language Switcher: If you want to close language switcher from the nav then you can turn it off from here.
• Skip Mail Configuration: While employee creation we can send a mail to the employee. If you want to skip this mail then you can turn it off from here. After the mail integration, enable it from here.

All changes define the default operational environment for the HR system. Click Update to save any changes you make.

Customization Options

• Company Logo for headers, login, and documents
• Color Scheme for primary/secondary colors
• Company Information (name, tagline, contacts)
• Favicon for browser tabs and bookmarks
• Email Templates with branded headers/footers
• Document Branding for reports and official documents

Available Integrations

• Firebase: Real-time sync, auth, and cloud storage
• Storage: Local or cloud (e.g., AWS S3) file storage
• Mail: SMTP settings for outgoing email.
• Google Font: Customize app typography
• Google Map: Enable location features
• Pusher: Real-time communication (channels)
• reCAPTCHA: Protect forms from bots
• Tawk: Live chat support widget
• PWA: Progressive Web App capabilities

The Language Settings section allows administrators to:

• Set the default system language
• Add new language packs
• Configure language-specific formatting for dates, numbers, and currency
• Support both LTR and RTL text directions
• Let users switch languages from their profile
• Manage translations for custom content and system messages

Centralized language management ensures consistent UX across all modules while honoring cultural and linguistic preferences.

The Departments module provides centralized system that helps maintain a clear organizational structure and enables efficient employee categorization and management across various business units.

Organizational Structure

Well-defined designations help create a clear organizational structure, improve communication channels, and establish proper authority levels throughout your company.

Weekend Configuration Best Practices

• Consider your organization's operational requirements when setting weekends
• Ensure weekend patterns align with local cultural and religious practices
• Coordinate weekend schedules with client and vendor availability
• Plan for adequate coverage during weekend periods
• Regularly review and adjust weekend patterns based on business needs
• Communicate weekend schedule changes well in advance to employees

Common Holiday Types

• National Holidays: Independence Day, National Day, Constitution Day
• Religious Holidays: Christmas, Eid, Diwali, Chinese New Year
• Cultural Holidays: Labor Day, Mother's Day, Father's Day
• Company Holidays: Founder's Day, Company Anniversary, Team Building Days
• Regional Holidays: State-specific or province-specific observances
• Seasonal Holidays: Summer break, Winter holidays, Spring festival
• Emergency Holidays: Declared holidays for special circumstances
• Optional Holidays: Floating holidays that employees can choose to observe

Holiday Management Best Practices

• Plan and announce holidays well in advance for better workforce planning
• Consider local customs and religious diversity when setting up holidays
• Establish clear policies for holiday compensation and overtime rates
• Regularly review and update holiday calendars for accuracy
• Coordinate with payroll and attendance systems for seamless integration
• Maintain compliance with local labor laws and holiday regulations

Key Features

• Leave Type Creation: Create custom leave types with specific names and descriptions
• Entitlement Configuration: Set default leave balances and annual allocations
• Gender-Specific Leave: Create leave types specific to gender requirements
• Status Management: Enable or disable leave types as needed

Common Leave Types

• Annual Leave: Yearly vacation entitlements for rest and recreation
• Sick Leave: Medical leave for health-related absences
• Casual Leave: Short-term personal leave for urgent matters
• Maternity Leave: Extended leave for new mothers
• Paternity Leave: Leave entitlement for new fathers
• Emergency Leave: Urgent leave for unexpected family situations
• Study Leave: Educational leave for professional development
• Compensatory Leave: Time off compensation for overtime work
• Bereavement Leave: Leave for mourning and funeral arrangements
• Religious Leave: Leave for religious observances and festivals

Leave Management Best Practices

• Create clear and descriptive leave type names and policies
• Set realistic entitlement balances based on company policy
• Configure appropriate approval workflows for different leave types
• Regularly review and update leave policies for compliance

Leave Assignment Best Practices

• Establish clear leave policies and entitlement criteria
• Consider probation periods when assigning leave to new employees
• Regularly review and update leave balances based on policy changes
• Maintain accurate records for audit and compliance purposes
• Communicate leave policies clearly to all employees

Understanding Role-Based Access Control

TrustedHRM implements a comprehensive role-based access control (RBAC) system that allows you to:

• Define User Roles: Create custom roles tailored to your organizational hierarchy
• Set Granular Permissions: Control access to specific modules, features, and data
• Manage User Access: Assign and modify user permissions based on job responsibilities
• Maintain Security: Ensure data protection through structured access controls
• Audit Access: Track user activities and permission changes for compliance

Default System Roles

Setup Steps

1. Employee Setup
2. Official Setup
3. Personal Info
4. Personal Documents
5. Salary Configuration

Leave Application Workflow

The leave application process in TrustedHRM is designed for simplicity and transparency:

• Application Submission: Select leave type, dates, and provide reason for leave
• Manager Review: Automatic routing to his manager. Manager can be updated from Employee > Click on "Action" and then click on "Edit" of the User > Office Setup > Manager
• Approval Process: Multi-level approval workflows with email notifications
  • Accept: Leave will be approved
  • Reject: Leave will be rejected
  • Refer: Leave will be referred to another person
• Balance Tracking: Real-time leave balance updates and accrual calculations

Leave Types & Policies

• Annual Leave / Vacation Days
• Sick Leave with medical certificate requirements
• Maternity/Paternity Leave
• Emergency Leave
• Compensatory Off (Comp Off)
• Work From Home requests
• Half-day and partial day leave options
• Custom leave types based on company policy

Communication Features

TrustedHRM provides comprehensive tools for organizational communication:

• Company Announcements: Broadcast important news and updates to all employees
• Department Notices: Target specific teams or departments with relevant information
• Policy Updates: Distribute HR policies, procedures, and guidelines
• Event Notifications: Announce company events, training sessions, and meetings
• Emergency Alerts: Send urgent communications with priority flags