whmcs illustrated installation guide

in Blog

WHMCS Installation: an illustrated step by step guide

Whether you are a ginormous hosting company or a one man band, WHMCS can help you manage tons of domains. I’ve been using it personally for a number of years now, and have recently added another install since I’ve co-founded our hosting company.

If you landed here, chances are you need some help getting setup. This is no easy task!

For the purpose of this post I’ll assume you are on a LAMP server (Linux, Apache, MySQL, PHP) and have a basic understanding of the Linux command line. If you don’t you pretty much don’t have any business installing WHMCS.

I’ll also assume you are using Windows, which isn’t a great assumption for the most part but it is what I was working with.

Here we go!

Start by downloading the latest version of WHMCS. Once you’ve downloaded the zip, unpack it. It doesn’t really matter what you name it but I named it WHMCS. There is a file called configuration.php.new rename that to configuration.php. K?

1 download WHMCS

Take the contents of your folder and upload it to a folder within public_html folder. I named mine billing just because. In some rare cases you can upload directly to your public_html folder but that might depend. This might take a while depending on your connection.

2 drop in ftp

Once all the files are done, visit the installation setup URL at:


After this you pretty much just have to follow the instructions on screen.

3 go to url

Say yest to the dress. (I agree)

4 say yes to license

At this point if you are a savvy sysadmin your server will have passed all of the checks. If not you will have to fix these issues or contact your hosting company.

5 passed

Database and database user creation time! Should be self explanatory here but you get the idea.

6 create database

Choose some good passwords and a solid username.

7 deetz

Once installation is complete, you’ll get some more suggested installation instructions. Mainly security stuff and maintenance stuff. You’ll also have to setup a cron job.

8 complete

You can change permissions in FTP or command line.


10 perms

Another necessary step. What this step basically does is make it so the important stuff is not visible to the world, at all.

11 add this line

Ah, .htaccess eding.

12 htaccess password

Another optional step, but good to lock things down.

13 password protect directory

I had to strip out some of this, but you should get the idea.

14 move crons folder and change config

15 execute cron job

16 perms
Step up the cron job to run once per day.

17 add new cron job

If all goes well you should see the admin screen, good luck!

got it

Patrick Coombe

Patrick Coombe

Patrick Coombe is an internet entrepreneur, SEO consultant and web developer living in Delray Beach, FL. He is the founder of Elite Strategies.
Patrick Coombe
Patrick Coombe
Patrick Coombe

Latest posts by Patrick Coombe (see all)

Loading Facebook Comments ...