Download and Installation

You should be able to download the gem just by running

$ sudo gem install YurtCMS

If You are Updating From a Prior Version

If you are updating from an older version of the cms, don't run yurt newsite; instead, cd into the directory and run

$ yurt update

This will update any files in the yurt directory, and give you the new features.

Starting a New Website

If you are not updating from an older version, the next step is to get a CMS admin area set up. cd to where you'd like to set it up, then run

$ yurt newsite your_new_site_name

This will create a new directory called your_new_site_name/ and add in all the required files.

Webserver Configuration

As part of the process for setting up a new CMS, yurt newsite writes out a pre-configured apache configuration file. You'll need to integrate this into your existing configuration.

Mac OS X Specific Installation Instructions

On Mac OS X, the apache configuration is designed to auto-include configs from /etc/httpd/users/. We're going to make use of this handy feature to add our own configuratioin.

Copy the your_new_site_name/your_new_site_name.conf file into /etc/httpd/users/ You will have to employ sudo for the copy to work. Here's what you need to type:

$ sudo cp your_new_site_name.conf /etc/httpd/users/
Password: <enter your password here>

Restart the server:

$ sudo apachectl restart

And that's it! From here you can start building out your site.

Go to http://localhost:9878/yurt/ to access the web interface, or you could go into your_new_site_name/content, and start building out the content.