There are two main ways to download Mephisto: either download the latest release as a tar.gz file, or grabbing a version from Subversion. The Download page has more info on the various versions available in subversion.
Next, you have to make sure your host is setup to run rails apps. This varies from host to host, so I’ll leave this step up to you. The only gem that Mephisto needs is tzinfo (which is included with the tar.gz download). If you don’t have this, read Installing Mephisto Without Required Gems. Mephisto will use RMagick for asset thumbnails if it is available, but will function just fine without it.
1. Create a database named mephisto (or one of your choosing).
2. Copy config/database.example.yml to config/database.yml
3. Edit database.yml and set your database credentials.
4. Upload the entire mephisto directory to your webserver.
5. Make sure you upload the tzinfo gem (see above) with the directory, or that your host has it preinstalled.
6. Run rake db:bootstrap from a terminal of some sorts (use rake db:bootstrap RAILS_ENV=production to be sure you’ve bootstrapped the production database.)
7. Login to your administration at http://domain.com/admin with the username: admin and password: test
The actual web server installation varies from host to host. Mephisto should install like any other Rails app, however. The wiki has some directions for specific hosts.
Upgrading (with a downloaded copy)
When upgrading, it’s usually best to install the new copy of Mephisto in a completely separate directory. This way if something happens to go wrong, you can restore the database and point the web server to the old directory to continue using the older version.
1. Download Mephisto into a separate directory
2. Copy config/database.yml, public/assets, and /themes to the new installation. Also be sure to copy any other customized files you may have (such as config/environment.rb possibly).
3. Backup your database just in case.
4. Run rake db:migrate RAILS_ENV=production to make any necessary changes to the database. This will affect your current site’s database, so either take it offline, or perform this step on a secondary database.
5. Reconfigure your web server to point to the new application.
Upgrading (with a subversion working copy)
1. Update from the latest svn
2. Backup your database just in case.
3. Run rake db:migrate RAILS_ENV=production to make any necessary changes to the database. This will affect your current site’s database, so either take it offline, or perform this step on a secondary database.
4. Restart Mephisto and your web server if needed.