Why Proper Setup Matters
Setting up Perfex CRM correctly from the start saves you from performance issues, security vulnerabilities, and data loss down the line. A properly configured installation runs faster, sends emails reliably, and protects your client data.
Server Requirements
Before you begin, make sure your server meets these minimum requirements:
- PHP 8.1 or higher (8.2 recommended)
- MySQL 5.7+ or MariaDB 10.3+
- 2GB RAM minimum (4GB recommended for production)
- mod_rewrite enabled (Apache) or equivalent (Nginx)
- cURL, GD, mbstring, OpenSSL PHP extensions enabled
Step 1: Download & Upload Files
Purchase Perfex CRM from CodeCanyon and download the latest version. Extract the ZIP file on your local machine. Upload the contents of the upload folder to your server's public_html (or a subdirectory) using cPanel File Manager or an FTP client like FileZilla.
Step 2: Create MySQL Database
In cPanel, navigate to MySQL Databases. Create a new database (e.g., mysite_perfex), create a database user with a strong password, and assign the user to the database with ALL PRIVILEGES. Note down these credentials — you'll need them in the next step.
Step 3: Run the Installation Wizard
Navigate to your domain in a browser (e.g., https://yourdomain.com). The Perfex CRM installation wizard will load automatically. Enter your database host (usually localhost), database name, username, and password. Then fill in your admin account details and click Install.
Step 4: Configure SMTP Email
Go to Setup → Email Settings. Choose your SMTP provider — Gmail (use App Password), Mailgun, or your hosting SMTP. Enter the SMTP host, port (587 for TLS), username, and password. Send a test email to verify it works correctly before going live.
Step 5: Set Up Cron Jobs
Cron jobs handle automated tasks like recurring invoices and reminders. In cPanel, go to Cron Jobs and add the following entry to run every minute:
* * * * * php /home/username/public_html/artisan schedule:run >> /dev/null 2>&1
Replace the path with your actual installation path.
Step 6: Security Best Practices
Secure your installation with these steps: install an SSL certificate (free via Let's Encrypt), enable two-factor authentication for admin accounts, set file permissions to 755 for directories and 644 for files, and consider installing fail2ban to block brute-force login attempts.
Common Installation Errors & Fixes
- Blank white page: Enable PHP error reporting, check that all extensions are enabled, verify file permissions.
- DB connection failed: Double-check your database credentials and make sure the user has full privileges.
- Email not sending: Test SMTP settings, check if your host blocks port 587, try switching to port 465 with SSL.
Conclusion
A properly installed Perfex CRM is the foundation of a reliable business system. Follow these steps carefully and you'll have a fast, secure installation ready for your team.
Need expert setup? Websicon offers professional Perfex CRM installation — get it right the first time.
Ready to get started?
Let Websicon build your perfect CRM solution
Free consultation · No long-term contracts · 100% satisfaction guarantee
Get Free Consultation