Here is a quick guide to get Apostrophe CMS, up and running on our Shared hosting servers.

We are going to assume that you either have Apostrophe running on your local development environment, or that you will install the sandbox version that you can download from the site.

Installing the Apostrophe Sandbox

First of all, login to your Control Panel account and make sure you have SSH enabled for your domain. This can be done in the Setup section of the domain.

Enabling SSH

Enabling SSH

Next, in the Control Panel, go ahead and create your database and database user. Go to Databases under your domain and add a new database and then a new username.

Next, connect with your SSH client go to /symfony_projects directory and execute:

svn co http://svn.apostrophenow.org/sandboxes/asandbox/branches/1.3 asandbox

Once it finished executing all the SVN checkouts, you will have a complete Apostrophe installation in asandbox. Go into asandbox directory and create copies of the needed configuration files:

cd asandbox
cp config/databases.yml.sample config/databases.yml
cp config/properties.ini.sample config/properties.ini

Edit config/databases.yml and configure the database connection with the database/username created in the previous step. Make sure to change dbname, host, username and password to match your account.

all:
  doctrine:
    class:        sfDoctrineDatabase
    param:
       dsn:        mysql:dbname=ademo;host=sg108.servergrove.com
       username: ademo
       password: yourpassword

Run the following symfony tasks:

./symfony cc
./symfony plugin:publish-assets
./symfony doctrine:build --all
./symfony doctrine:data-load

This will create the default database and load the default configuration. You can also setup a default demo by running:

./symfony apostrophe:demo-fixtures

And finally run:

./symfony project:permissions

Before you are done there is a very important step. You need to configure the web server to use your Apostrophe installation. Go into the control panel and into the Maestro section. Select the asandbox project and go to Setup WebServer and click OK.

Setting up Apostrophe with Maestro

Setting up Apostrophe with Maestro

At this point, your Apostrophe installation has to be working, so go ahead and load your site

Apostrophe demo running

Installing Apostrophe from your development environment

If you have Apostrophe running in your development environment there are many common steps with the sandbox installation. First, enable SSH and create the database and database user in the Control Panel as described above. Then import a SQL dump of your database and import it using the DB WebAdmin in the Control Panel.

Next, upload your Apostrophe project into symfony_projects. You can upload the files using a FTP client or you can checkout your SVN repository or clone your GIT repository using the SSH client. Edit databases.yml so the connection information matches the shared hosting server settings as done in the sandbox installation above.

Next, run the following commands

./symfony cc
./symfony plugin:publish-assets
./symfony project:permissions

And finally, use Maestro as described in the sandbox installation to setup the web server to use Apostrophe project. It is that simple!