Install

Installing Puma is a very straightforward task. First, decide how you want to get Puma: via Subversion, or through a package on SourceForge.

To get Puma through Subversion:
svn co https://pumacms.svn.sourceforge.net/svnroot/pumacms/trunk puma

To get Puma via SourceForge, download the appropriate package, and uncompress it.
Now, before we continue, be sure to check that you have all the dependencies installed! (See the puma/DEPENDANCIES file). You will, of course, also need a functioning web server (such as Apache or Lighttpd) with a PHP module (like mod_php), and MySQL installed.
Now, you’re almost there!

  1. Create a database for your Puma pages. We call it ‘puma’. Also create a user, and grant it all privileges on ‘puma’. We call ours ‘user’.
  2. Type: mysql -p -u user puma < schema.sql . This will create the appropriate tables in your database. WARNING! This will delete anything currently in the database!
  3. If your database isn’t named “puma,” you’ll have to manually rename models/puma.ini to reflect that.
  4. Edit config.ini to your liking.
  5. Point your browser to the new installation, for example: http://www.example.com/puma/ .
  6. Log in as admin (the password is ‘password’) and immediately change the password! (Otherwise everyone will know that the password is ‘password’.)
  7. The default template scheme is meant to be as plain as possible, to encourage you to develop your own.  Puma uses the PHP templating engine Smarty for page rendering.  You can override any template by putting a like-named file in the site/templates directory (you’ll have to create these directories yourself).

That’s all! A guide to using Puma can be found in the docs/guidedtour/ directory.