Composr Tutorial: Basic Installation

Before you begin using Composr, you will need to install it. Installing Composr is easy with our installation utility, which will be explained in detail in this tutorial.

Your options (preface)

Before we dive into instructions, we should lay out the different options you have for installation.

Your options are:

• Install on traditional hosting (shared hosting/VPS)
  • Use a supported integration. You can install with just a few clicks if your webhost has a supported integration such as Softaculous or Installatron installed. If this is the case then you don't need to read this tutorial.
  • Use the quick installer. This tutorial covers this case.
  • Use the manual installer. You are unlikely to need to use the manual installer. If you do, the Advanced Installation tutorial provides supplementary information to the installation fundamentals described in this tutorial.
  • Get a professional developer to install for you.
• Install on dedicated server or cloud machine (IaaS). If a control panel is provided then installation may be identical to traditional hosting. Otherwise you will need to have a more advanced understanding of server management. Many details are described in the Advanced Installation and Webhosting for Composr tutorials.
• Install on a PaaS service. PaaS services are typically managed directly by programmers and specific instructions would vary greatly between service.
• Install on a Windows machine
  • Use a WAMP system. Covered in the Installing Composr on a Windows desktop tutorial.
  • Use Bitnami. Covered in the Installing Composr on a Windows desktop tutorial.
  • Use Microsoft Web Platform. Covered in the Installing Composr on a Windows desktop tutorial.

Prerequisites

Before you install Composr:

1. Ensure that your host covers our minimum requirements.
2. Consider getting a general knowledge of web applications. This is not required but it will give you some overall understanding of what kind of web systems there are and how they work.
3. Make yourself familiar with the 'Webhosting control panel' your webhost has provided. Common ones include Plesk and cPanel. Your host may not name the control panel, but they will have provided you to the details to log in to it. You will typically use the control panel to set many things up, including: databases, possibly subdomains, possibly SFTP/FTP accounts, e-mail accounts.
4. You also need the following information from your webhost:
   
   • SFTP/FTP hostname
   • SFTP/FTP username
   • SFTP/FTP password
   Usually SFTP/FTP details are instead e-mailed to you when you sign up for hosting. Sometimes you need to set themselves up yourself in the control panel, particularly if you are installing to a subdomain.
5. You need to set up a database, and note down these details:
   
   • MySQL hostname
   • MySQL username
   • MySQL password
   • MySQL database name
   Typically you can set the database up yourself in the control panel. It can be a bit fiddly, so here are instructions for cPanel and Plesk. You typically need to create the MySQL user first, then the database, then provide access for the user to the database. The hostname is usually either just 'localhost', or something specific that the control panel will tell you. Be careful that often you don't get the exact username and database name you specify: often prefixes are added for you, and you'll be shown this if you look carefully. Composr will need to know the full names when you install. Make the MySQL password random and unique, as it will be stored in plain-text in your site configuration.

Composr does not need its own database (i.e. it can share one), but if you are able to create a new one it is often preferable for reasons of tidiness. The database user needs full read/write/administer access over the database Composr will be installed in. Sometimes you set this access by ticking (checking) to have all permissions on your user. Sometimes you do it by setting the 'User role' to something such as 'dba' (e.g. h-sphere on Windows).
Specifically for MySQL the low-level permissions needed are:

• Read: SELECT
• Write: INSERT, UPDATE, DELETE
• Administer: CREATE, DROP, ALTER, INDEX

Similar products require the same information.

If you would like to use a 3rd party forum system for your website, we require that you install that before installing Composr. We recommend you use the inbuilt forum though (Conversr).

Deciding: Quick or manual install

At some point you'll need to decide which method you'd like to use to install Composr. You have two options, the quick installer, or the manual installer.

We highly recommend choosing the quick installer. This is a simple process, where you upload two files to your web server, then launch our installation utility from there. It works on most servers.

The second option is the manual installer. This option requires you to manually upload all of Composr's files using something like FTP and apply permissions to them – the typical method for most CMSs. This method takes much longer – as there is a pause for "handshaking" between each file. We maintain this version in case the quick installer fails on your host (e.g. if the host does not support PHP-accessible FTP or suEXEC in the way the quick installer needs).

Preparing files

Using SFTP/FTP

An alternative to uploading via SFTP/FTP is using the File Manager within the webhosting control panel. However it is worth trying to get it working using SFTP/FTP, as it is a valuable basic tool.

The next step is to upload the files to your web server. To do this you'll need an SFTP/FTP client (such as FileZilla, or use the one that comes with Windows). The exact steps to upload the files depend slightly depending on which SFTP/FTP client you choose.

If you'd like to use the one bundled with Windows, open a new Internet Explorer window, and in the address bar, type ftp://username@servername.com, replacing username with your username and servername with the servername given to you by your webhost. You should be presented with a login screen (if not, you can access it by choosing File > Login As), where you can enter the username and password given to you by your webhost (image). Then you'll need to navigate to your webroot (possibly in a folder called www or httpdocs). If you can't find your webroot, e-mail your webhost for help.

At this point you need to decide whether you want your website to reside in your root folder or not. If you choose to place it in your root folder (which is the recommended option), people will be able to access your site by going to http://yourbaseurl (unless you don't own your own domain name). If you choose to place it in a subfolder (for example, "subfolder"), people will access your Composr installation by going to http://yourbaseurl.

When you successfully connect, find your webroot, and navigate into a subfolder if you chose to. You need to upload the files that were inside the ZIP package you downloaded. If you chose the quick installer, these files are called 'install.php', the other is called 'data.cms'. If you chose the manual installer, there will be many more.

You now need to put these files in the desired folder. This can usually be done by dragging and dropping the files from your computer to your webhost in your SFTP/FTP client (image).

Installation

The Setup Wizard ("Configure my Composr first") will guide you through some basic setup for your site, to give you a leg-up. It is not required, but most users will want to run it to set some basic things such as Site Name, colours, and what addons are to be kept installed.

Advice for webhosts

Note that Composr administrators have full control over their website code. They may execute their own custom PHP code trivially.

Therefore if you control the hosting and provide someone with a Composr staff username you should ensure that your hosting is either:

1. locked down to only that site
2. that you provide a non-administrator staff account
3. that you trust any administrator with full control over the hosting

See also

• Basic Configuration
• The user-focused help page within Composr (linked from the menus)
• Web applications information
• Webhosting information (including Composr minimum requirements)
• Installing Composr on a Windows desktop
• Advanced installation
• Uninstalling Composr

Feedback

Have a suggestion? Report an issue on the tracker.