This guide will show you through the steps on installing your software from the installer. If you have not yet downloaded the software and uploaded this to your site, please see the previous guides in the menu on your left.
Prior to installing, you will need to ensure you have set up a database, and have the database name, and credentials for your database to hand. If you are not sure on how to set one of these up, please speak to your hosting company on this.
If you have got to this stage, then you have everything you need for installation of your software. Next you will need to visit the installer itself. You can get to this from the browser location corresponding to where you added your files and folders. In this example I have added my files to public_html/demo/ which is my sites directory, within a demo folder. This would correspond to http://localhost/demo/ . This being my location for the site, I would now go to the installation path /admin/install/ , which is in this case would be the following
Once we have visited that location in our browser, we see the following screen
Click on "START INSTALLATION" which will take you to the requirement check screen. If you followed the previous guides, everything should be showing as ok in here. If you get any messages in here such as folder permission errors, you would need to resolve these at this point before you continue.
Once you click continue, you will then be asked for your license key. You can find your license key from within your client area if you are unsure of what this is. You can then select to accept the license agreement and continue with the installation.
Your IPS Community Suite license allows you to have one live installation (your actual community) and one test installation. We also allow an unlimited number of installations on "localhost" domains so you can test locally without restriction.
If you are installing on a test install, enter your license key with -TESTINSTALL on the end. If you are installing on localhost (it must be "localhost" specifically, not "127.0.0.1" or any other alias), this will not count towards either of your installations, however, if you are installing on any other domain, it will count as your test installation.
This means that if you already have a test installation at a different URL, you will receive an error message that says "A test installation has already been activated for this license key. Your license key entitles you to one test installation only." There are three ways to overcome this:
You can delete your current test installation and reinstall at the same URL. For example, if your Test URL (as shown in the client area) is "example.com/test", you can install at example.com/test (meaning of course you'll have to delete whatever is there first) and you will not get the error message.
You can install on a localhost installation: localhost installations do not count towards your allowed usages.
You can reset the licensed URL associated with your license. The test url is a one time url, so use something you can retain for future testing. To prevent abuse, we only allow this to be done once every 6 months, so do not use this option unless for example, you no longer have access to the domain where your test installation was previously. To do this, click "reset URL" on the same page in the client area.
Finding your license key
Your license key can be found in our client area. To find it:
Log into our client area with the account details you set up when you purchased your license
Click the Purchases & Downloads tab in the left-hand menu
Find the row of the license you wish to use for this installation
The license key is shown underneath the title. You can copy and paste it from here by selecting the numbers, right-clicking, and choosing Copy.
The next page will ask you what items you wish to install. All items you have purchased will be within this list, however if there are any you do not wish to install at this time, you can deselect them at this point.
At the bottom you will also see a dropdown menu to select your default application. This will set what your users see on you first page. So in this case, what they will see at localhost/demo . Note that you can change this after install if needed.
We will now be asked to enter the details for our database. Usually you will only need to enter your username, password, and database name here. All the rest should be left as default unless you know otherwise. If you are unsure on this, please speak to your hosting company who will be able to guide you on any other information you need to change.
You will next be asked to enter your administrator account details. These are details which will be used to create the first admin account on your site, which will have full permissions on your site. You will use these once you are installed to log in, and to administer the rest of your site. More admin account can be set up after installation if needed.
Your site will now run through the installation automatically
Once your installation is complete, the system will let you know, and you can chose whether to visit your admin CP or your main site. Please see our many other guides for assistance on using the suite, and welcome to IPS.