by Typex

Instantly upload files and emails to SuiteCRM by dragging from your desktop or Outlook — including the New Outlook app.

Cancel at any time!
Free Trial

Installation Guide

Install / Upgrade Guide

Server Requirements

PHP Version

  • Minimum: PHP 7.4
  • Recommended: PHP 8.x

Required PHP Extensions

Extension Purpose How to Install
cURL Microsoft Graph API calls sudo apt install php-curl
JSON Data encoding/decoding Usually included by default
mbstring UTF-8 character encoding sudo apt install php-mbstring
fileinfo File MIME type detection sudo apt install php-fileinfo

Required Composer Packages

Package Purpose Install Command
zbateson/mail-mime-parser Parse .eml email files composer require zbateson/mail-mime-parser
hfig/mapi Parse .msg files (Classic Outlook) composer require hfig/mapi

Run these commands in your SuiteCRM root directory:

composer require zbateson/mail-mime-parser
composer require hfig/mapi

PHP Configuration (php.ini)

Recommended settings for handling email attachments:

upload_max_filesize = 25M
post_max_size = 30M
memory_limit = 256M
max_execution_time = 60

Network Requirements

  • Outbound HTTPS (port 443) to:
    • login.microsoftonline.com (Azure authentication)
    • graph.microsoft.com (Microsoft Graph API)
    • store.suitecrm.com (License validation)

Other Requirements

  • SuiteCRM 7.x or 8.x
  • Admin access to SuiteCRM
  • Write access to SuiteCRM upload directory
  • Google Chrome or Microsoft Edge browser

Installation Steps

  1. Download the Module

    • Download the ZIP file from the SuiteCRM Store
  2. Upload to SuiteCRM

    • Log in to SuiteCRM as an administrator
    • Go to Administration > Module Loader
    • Click Choose File and select the downloaded ZIP
    • Click Upload
  3. Install the Module

    • Find the module in the list and click Install
    • Review and accept the license terms
    • Wait for installation to complete
  4. Configure the Module

    • Go to Administration > Browser Upload
    • Enter your license key and click Validate License
    • Select which users should have access
    • Click Save Configuration
  5. Install Browser Extension

    • Install the companion extension from the Chrome Web Store
    • Or load it manually in developer mode

Upgrading

  1. Backup First

    • Export your current configuration settings
    • Note your licensed users selection
  2. Upload New Version

    • Go to Administration > Module Loader
    • Upload the new version ZIP file
    • Click Upgrade
  3. Verify Settings

    • Go to Administration > Browser Upload
    • Verify your settings are preserved
    • Re-validate your license if prompted

Uninstalling

  1. Go to Administration > Module Loader
  2. Find the module in the installed list
  3. Click Uninstall
  4. Your configuration settings will be preserved in case you reinstall

Saving Comment Saving Comment...