Install on Shared-hosting (Bluehost, GoDaddy or similar)¶
You can install OpenCATS right to your shared hosting account! This way OpenCATS will be web accessible from any computer and multiple users, without the hassle of setting up and running a server.
These instructions will walk you through setting up OpenCATS on a Bluehost hosting account. Major web-hosts should be a similar process, though you may have to search and make small tweaks.
There are benefits and down-sides to running your OpenCATS system through a shared hosting account. The main benefit is that OpenCATS will be web accessible to any user from any location, and not limited to your local machine. You will however lose the resume-indexing tools with a shared-hosting environment. Which means that resumes will NOT be keyword searchable.
As this documentation gets updated, the OpenCATS version in the images may not match the OpenCATS versions discussed in the documentation.
Download OpenCATS to your computer¶
Click this link to download the OpenCATS files, we will need them later:
All images use Bluehost for an example. If you have a different hosting provider, this will likely look a little different.
Log in to your shared hosting account and click
Scroll down to the “files” section and click “File Manager”.
It will open up a new tab in your browser.
Double click on your main web directory (mine is listed as public _html)
Now we need to upload the OpenCATS zip file that we downloaded into this directory
This should bring you to a file upload screen.
- Find the
opencats-0.9.4-full.zipfile that we downloaded and select it.
Make sure you wait for the upload to complete before going back into the public _html folder
- When the upload is finished, click the
Go Back to public _html
- Scroll down to the
opencats-0.9.4-full.zipwe just uploaded and click it once to highlight it.
- Click on
Extractat the top to extract the OpenCATS files from the Tar file.
This should open a new screen:
The default address should be fine, click
Now you should see the extracted folder
home listed in your public _html directory.
Currently, the directory in the above image should say
If you want to rename the folder, that’s ok. The folder name will be part of the web address you use to access your OpenCATS Installation.
- Double click on the
homedirectory, then click
travis, then click
build, then click
opencats. Now you should see the final
- Right click on the
move), and place the file in your main html directory (called public_html or something similar).
- Go back into your main html directory (public_html or something similar), right click and delete the
homefolder (NOT the home.html file if you have one there).
- Double click on the OpenCATS directory and find folder named
INSTALL_BLOCK, right click and delete it. The
INSTALL_BLOCKfile or directory will prevent OpenCATS from installing on your system.
- Return to the main CPanel screen.
Changing PHP versions on hosting accounts MAY affect web sites or programs that are already installed. You should back up any critical websites or programs BEFORE switching PHP versions.
- Scroll down to the Programming section and click on “PHP Config”.
This will open a screen to select what version of PHP your hosting is running. OpenCATS should have PHP 5.6. Select whatever PHP 5.6 option you prefer, I usually have the single ini option selected.
- Scroll down and click
save changes, then go back to the main CPanel dashboard.
You will need the MySQL database name, user name and password later. Make sure you write it down as you create them.
- Scroll down to the Database Tools section and click
- Type in a MySQL database name (whatever you want, for this I am doing “octest2”).
- Click next step.
- Enter a database username (whatever you want, for this I am doing “octest2”).
- Enter a password. For shared hosting, it should be a strong password.
Some hosting services will add account specific things to MySQL usernames and database names. Note the red box in the image below. THESE will be the user names and database names we enter into our OpenCATS system.
If everything has been done correctly, you should be done in your web hosting account.
- Open your web browser
Install the OpenCATS software¶
In your browser, go to yourdomainname.com/OpenCATS (if you changed the main directory name, replace OpenCATS with the new name).
If you have already attempted to install OpenCATS and the installer doesn’t load, check to see if there is a file called ‘INSTALL_BLOCK’ in the OpenCATS directory. Delete it to allow the installer to run.
Step 1: System Connectivity
This step makes sure you have the required server environment set up correctly.
Green = good.
Yellow = OpenCATS will work, but some functions may not. Common yellow errors on shared hosting are for LDAP and SOAP extensions. These extensions are not necessary and you do not lose any functionality.
Red = Bad You can’t continue the installation until a server environment issue is fixed.
If you see all green and/or yellow, click
Step 2: Database connectivity
Enter your OpenCATS MySQL/MariaDB database name, MySQL/MariaDB database username, MySQL/MariaDB database password, and MySQL/MariaDB database host address in these boxes.
If you are running OpenCATS locally on your computer, or on some shared hosts, the host address will be localhost. If your server, VPS (some shared hosting too), you will need to enter the specific address to access.
Test Database Connectivity
I usually get red the first few tries after click the
test database connectivity button. If you try more than a couple times and it stays red, you have either entered your MySQL/Mariadb information incorrectly, or you have set your MySQL/MariaDB database up incorrectly. It needs to be corrected before proceeding.
Step 3: Loading Data
For a new installation, select
New Installation, then
Demonstration Installation will auto-populate OpenCATS with general example clients, candidates, job orders, etc. There’s no reason to use this in my opinion.
Restore installation from backup will be covered in a future tutorial
Step 4 Setup resume indexing
For a shared hosting environment, you can not use the resume indexing tools. You need root access to install these programs and most shared hosts do not allow that. Occasionally, with a smaller hosting company, you can contact them and request the programs be installed and they will do that.
Skip this step
Step 5 Mail Settings
OpenCATS can send emails. If you don’t want to use it, you don’t have to. OpenCATS works great either way!
If you do not know what your settings are, or don’t want the mail functionality in OpenCATS, click the drop-down bar and select
Choose an option from the Mail Support drop-down bar, fill the necessary information in (if you are using it) and click
Step 6 Loading extras
Don’t forget to set the time zone to your area!
If you forget to set the time zone ALL of the timestamps on every note in OpenCATS will be wrong. Set the time zone correctly. You will thank us...
Choose the date format you like best
(United States only) choose to install (if you want) zip code lookup
Step 7 Finishing installation
Runs through the installation process. You should see a box and some pretty bars moving. It shouldn’t take long.
The default username and password are: admin/admin (all lowercase)
Start OpenCATS for your login screen.
Your brand new OpenCATS applicant System!
Now you have a shiny, new Applicant tracking system...change your admin password...RIGHT...NOW. Click
change password. Do...it...right...now.