Homepage loads but other pages return 404. Why?

Rewrite rules are missing. Fix your .htaccess or Nginx config.

I uploaded .htaccess but it’s ignored.

Enable AllowOverride All in Apache settings.

Does HTTPS affect the 404 error?

Not directly, but you should use HTTPS for security.

What if I can’t edit server configs?

Ask your hosting provider to enable rewrites.

How can I confirm the fix?

Try accessing /index.php/clients . If it loads, rules are working.

Perfex CRM 404 Not Found After Installation – – Quick & Easy Solutions

2 min read

Table of Contents

Table of Contents
Why Does the Perfex CRM 404 Error Happen?
How to Fix Perfex CRM 404 Not Found After Installation
Apache .htaccess Fix
Nginx Configuration
IIS Rewrite Rules for Windows Servers
Localhost / XAMPP Subfolder Adjustments
Common Hosting Scenarios
Debugging the 404 Error Step by Step
Security Note: Don’t Forget to Delete Install Folder
Troubleshooting Checklist

This guide explains how to fix the Perfex CRM 404 not found after installation error. This common issue happens when your web server doesn’t properly handle rewrite rules. Don’t worry—these quick and easy solutions will help you resolve it step by step.

Table of Contents #

Why Does the Perfex CRM 404 Error Happen?
How to Fix Perfex CRM 404 Not Found After Installation
Apache .htaccess Fix
Nginx Configuration
IIS Rewrite Rules for Windows Servers
Localhost / XAMPP Subfolder Adjustments
Common Hosting Scenarios
Troubleshooting Checklist
FAQs

Why Does the Perfex CRM 404 Error Happen? #

Perfex CRM uses pretty URLs to make links clean and readable. If the server doesn’t redirect these links to index.php, the system breaks and displays 404 Not Found. The error usually appears on shared hosting or custom VPS setups missing rewrite configuration.

Typical causes of the Perfex CRM 404 not found after installation error include:

Missing or ignored .htaccess file on Apache.
Incorrect or missing try_files directive on Nginx.
No rewrite rules configured on IIS.
Localhost subfolder installs without adjusted RewriteBase.

How to Fix Perfex CRM 404 Not Found After Installation #

The fix depends on your hosting environment. Below are solutions for Apache, Nginx, IIS, and localhost.

Apache .htaccess Fix #

Ensure .htaccess exists in the root folder. Some hosts hide it, so enable “show hidden files.”

Sample .htaccess

RewriteEngine On

RewriteBase /

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^(.*)$ index.php/$1 [L]

</IfModule>

Steps:

Enable mod_rewrite on Apache.
Update VirtualHost to allow .htaccess: AllowOverride All.
Restart Apache.

📌 External Resource: Apache mod_rewrite Documentation

Nginx Configuration #

Nginx requires try_files to redirect traffic.

Sample Config

location / {

try_files $uri $uri/ /index.php?$args;

}

Also, check your PHP-FPM socket:

fastcgi_pass unix:/run/php/php8.1-fpm.sock;

📌 External Resource: Nginx Rewrite Documentation

IIS Rewrite Rules for Windows Servers #

If you’re hosting on IIS, you’ll need a web.config file.

Sample web.config

<system.webServer>

<rules>

<rulename=”PerfexRewrite”stopProcessing=”true”>

<matchurl=”^(.*)$” />

<addinput=”{REQUEST_FILENAME}”matchType=”IsDirectory”negate=”true” />

<addinput=”{REQUEST_FILENAME}”matchType=”IsFile”negate=”true” />

</conditions>

<actiontype=”Rewrite”url=”index.php/{R:1}” />

</rule>

</rules>

</rewrite>

</system.webServer>

</configuration>

Restart IIS after adding the config.

Localhost / XAMPP Subfolder Adjustments #

When installing Perfex CRM in a subfolder like http://localhost/perfex/, update your .htaccess:

RewriteBase /perfex/

Without this, Perfex CRM may show 404 errors for all subpages.

Common Hosting Scenarios #

Shared Hosting (Hostinger, Bluehost, GoDaddy): Ensure .htaccess is uploaded, and ask support to enable mod_rewrite.
VPS Hosting: Manually configure Apache or Nginx. Use SSH to test rewrite configs.
Cloud Hosting (AWS, DigitalOcean): Apply rewrite rules and verify with server logs.

Perfex CRM 404 Not Found After Installation

💡 Pro Tip: If you face issues, contact your hosting provider. Many hosts will fix rewrite rules on request.

Debugging the 404 Error Step by Step #

Enable Apache/Nginx error logging and check for rewrite failures.
Verify file permissions on .htaccess or web.config.
Use curl -I http://yourdomain.com/clients to test HTTP responses.
Open Chrome DevTools (Network tab) to see if requests hit index.php.
If rewrite rules are correct, check the PHP error log — sometimes misconfigured PHP causes a false 404.

Security Note: Don’t Forget to Delete Install Folder #

Once Perfex CRM is working, delete the /install folder from your server. Leaving it accessible can expose you to security risks. This is also a good time to double-check that HTTPS is enabled for all routes.

Troubleshooting Checklist #

✅ .htaccess uploaded in root.
✅ AllowOverride All enabled in Apache.
✅ try_files rule added in Nginx.
✅ IIS web.config created.
✅ Subfolder RewriteBase corrected.
✅ Clear caches and restart the web server.

Frequently Asked Questions #