Download and Install Simplicity

Download the tarball release and extract the contents to a folder on your web server, this at present should either be a locally configured Apache, or a development server. If you run Windows and do not have access to a Linux development environment then you should use VMware or VirtualBox, see this forum post for more information.

Creating the Virtual Host

You should create host name to run simplicity under, the easiest way to do this if it is running locally is to edit your hosts file; this is /etc/hosts on Linux or c:\window\system32\drivers\etc\hosts on Windows. to create a host name to use just add a line like the following:

# this could be whatever you want it to be, not just 'simplicity'.
127.0.0.1         simplicity 

# if you are not running simplicity on your local machine, you should enter the ip address of the development server here. For example,
# if this was 192.168.1.200, then you would use:
192.168.1.200     simplicity

Once you have created the host name, you can configure a virtual host in Apache with the ServerName configured to the host name you created. In apache 2 you create a config file in the sites-available folder in your apache config root (on Ubuntu this is /etc/apache), on my local machine I use:

NameVirtualHost *
<VirtualHost *>
        ServerName HOST_NAME
        DocumentRoot PATH_TO_SIMPLICITY

        <Directory />
                AllowOverride None
        </Directory>
        <Directory PATH_TO_SIMPLICITY>
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
</VirtualHost>

Create a file in the sites-available folder, generally this is named after the HOST_NAME you configured above. When the file is created run the following to enable it:

# a2ensite HOST_NAME
Site HOST_NAME installed; run /etc/init.d/apache2 reload to enable.
# /etc/init.d/apache2 reload

NOTE: This should be correct for most Debian / Ubuntu based systems, may differ for other distributions.

After you have completed the above you should now download the source to the location you specified above. You can get the source code either via SVN or the latest tarball release.

Tarball release

Simplicity 0.2-dev "Captain Koons" (md5,sig)

SVN

Latest release: http://svn.simplicityphp.com/releases/dev-0.2 Bleeding edge: http://svn.simplicityphp.com/trunk

Installing Simplicity

Once you have downloaded the code, you should copy the contents of the archive into the folder you created above, this should be the following files:

• simplicity/
• index.php
• COPYING
• LICIENCE

After you have copied the folders then simply point your browser at the host name you created, you should see the Simplicity setup screen and you just have to follow the on-screen instructions!

NOTE: If you are checking out using SVN then you should checkout just the simplicity folder directly into the folder you are using, then to upgrade later, you can just run svn update. In this instance, you will have to go to http://HOST_NAME/simplicity/setup in the browser to complete the installation.