Skip to content

Installation via Web Interface

DeskHive includes a web-based installer for easy setup.

Step 1: Upload Files

  1. Download the package from CodeCanyon
  2. Extract and upload all files to your server
  3. Set directory permissions:
bash
chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Step 2: Run Web Installer

Access the installer at:

https://your-domain.com/install

The installer will guide you through:

  1. System Requirements Check - Verifies PHP version, extensions, and permissions
  2. Database Configuration - Enter MySQL/MariaDB credentials
  3. Admin Account Setup - Create your administrator account
  4. Installation Complete - Database tables created and configured

Step 3: Initial Configuration

After installation, configure DeskHive at Admin → Support Desk → Settings:

General Settings

SettingDefaultDescription
Default departmentNoneDepartment automatically assigned to new tickets
Default priorityNonePriority automatically assigned to new tickets
Auto close days0Days of inactivity before a ticket is auto-closed (0 = disabled)
Enable auto-assignOnAutomatically assign tickets to agents
Tickets per page20Number of tickets shown per page

Customer Portal Settings

SettingDefaultDescription
Customer registrationOnAllow customers to self-register
Show Tickets pageOnDisplay the Tickets page in customer portal
Show Knowledge Base pageOnDisplay the Knowledge Base page in customer portal
Max tickets per day5Maximum tickets a customer can submit per day (0 = unlimited)

Notification Settings

SettingDefaultDescription
Notify staff on new ticketOnEmail agents when a new ticket is created
Notify staff on customer replyOnEmail agents when a customer replies
Notify customer on staff replyOnEmail customer when an agent replies
Notify customer on status changeOnEmail customer when ticket status changes
Notification emailEmptyOverride email address for outgoing notifications

Step 4: Setup Cron Job

Add the following cron entry to configure scheduled tasks for auto-closing inactive tickets:

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

Permissions

Configure user permissions in Admin → Settings → Roles. Edit the desired role and enable Support Desk permissions:

  • Tickets (Index, Edit, Delete)
  • Categories (Index, Create, Edit, Delete)
  • Departments (Index, Create, Edit, Delete)
  • Knowledge Articles (Index, Create, Edit, Delete)
  • Labels (Index, Create, Edit, Delete)
  • Custom Fields (Index, Create, Edit, Delete)
  • Products (Index, Create, Edit, Delete)
  • Canned Responses (Index, Create, Edit, Delete)
  • Agents (Index, Create, Edit, Delete)
  • Customers (Index, Edit, Delete)
  • Activity Logs (Index)

TIP

After installation, delete the /install directory for security.