Uninstall WHMCS
Contents
Overview
Should you need to uninstall WHMCS from your web server, then this can be accomplished by removing the files, data, and cron jobs that make up the installation. We have put together a short guide below which can aide in accomplishing this.
Note: Before removing WHMCS entirely, we recommend first backing up the configuration.php file and database as per the Manual Database Backup guide. These backups can be used to restore WHMCS should you wish to continue using it in the future. More information about this can be found on the Restoring WHMCS documentation page.
Removing WHMCS
Removing a WHMCS installation can be broken down into the 4 following steps:
- Delete the WHMCS Files and Folders
- Delete the Database
- Delete Existing Cron Jobs
- Disable Email Piping
Each of the four steps is addressed in detail in the following sections of this guide. Once all of the steps have been completed, the installation will have been successfully removed.
Delete the WHMCS Files and Folders
The first step to removing WHMCS would be to remove all files and folders that make up the WHMCS installation. This would typically be every file and folder found within your WHMCS directory, however if there are a number of non-WHMCS files located there as well, then differentiating whether a file is associated with WHMCS or not could prove difficult.
To this end we have put together a list of the WHMCS files and folders that we would expect to see in a WHMCS directory. This list can be found below in the Files and Folders section.
Delete the Database
The database is the second most integral part of a WHMCS installation. As such, the next step would be to delete the database from the web server.
This could be accomplish via a variety of methods such as via PHPMyAdmin, the mysql cli, or with the aid of a control panel such as cPanel or Plesk.
External Resources
Delete Existing Cron Jobs
A few cron jobs may have been configured to handle automated processes for the WHMCS installation. You will want to identify any configured cron jobs, and then delete these from the server.
The following are the most common files to have cron jobs configured to run:
- cron.php
- domainsync.php
- pop.php
For more information on cron jobs in WHMCS please refer to the Crons documentation page.
External Resources
Disable Email Piping and Importing
If WHMCS was configured to automatically pipe or import emails into the ticket system, make sure to disable piping or importing.
- For email piping, delete any forwarders that currently pipe mail to pipe.php.
- For email importing, delete the /crons/pop.php file.
For more information, see Email Piping and Email Importing.
Files and Folders
Files
aff.php
affiliates.php
announcements.php
announcementsrss.php
banned.php
cart.php
clientarea.php
configuration.php
configuressl.php
contact.php
creditcard.php
dist.loghandler.php
dl.php
dologin.php
domainchecker.php
downloads.php
index.php
init.php
knowledgebase.php
link.php
login.php
logout.php
networkissues.php
networkissuesrss.php
pwreset.php
register.php
serverstatus.php
submitticket.php
supporttickets.php
unsubscribe.php
upgrade.php
viewemail.php
viewinvoice.php
viewquote.php
viewticket.php
whois.php
Folders
admin
assets
attachments
crons
downloads
feeds
includes
lang
modules
oauth
pipe
resources
status
templates
templates_c
vendor