Merged trunk r1773.

git-svn-id: http://redmine.rubyforge.org/svn/branches/work@1774 e93f8b46-1217-0410-a6f0-8f06a7374b81

groups/doc/INSTALL

@@ -1,25 +1,22 @@
 == Redmine installation
 
 Redmine - project management software
-Copyright (C) 2006-2007  Jean-Philippe Lang
+Copyright (C) 2006-2008  Jean-Philippe Lang
 http://www.redmine.org/
 
 
 == Requirements
 
-* Ruby on Rails 2.0.2
-* A database (see compatibility below)
+* Ruby on Rails 2.1
+* A database:
+  * MySQL (tested with MySQL 5)
+  * PostgreSQL (tested with PostgreSQL 8.1)
+  * SQLite (tested with SQLite 3)
 
 Optional:
 * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
 * RMagick (gantt export to png)
 
-Supported databases:
-* MySQL (tested with MySQL 5)
-* PostgreSQL (tested with PostgreSQL 8.1)
-* SQLite (tested with SQLite 3)
-
-
 == Installation
 
 1. Uncompress the program archive
@@ -33,24 +30,33 @@ Supported databases:
    rake db:migrate RAILS_ENV="production"
    It will create tables and an administrator account.
 
-5. Test the installation by running WEBrick web server:
+5. Setting up permissions
+   The user who runs Redmine must have write permission on the following
+   subdirectories: files, log, tmp (create the last one if not present).
+
+   Assuming you run Redmine with a user named redmine:
+     mkdir tmp
+     sudo chown -R redmine:redmine files log tmp
+     sudo chmod -R 755 files log tmp
+
+6. Test the installation by running WEBrick web server:
    ruby script/server -e production   
   
    Once WEBrick has started, point your browser to http://localhost:3000/
    You should now see the application welcome page
 
-6. Use default administrator account to log in:
+7. Use default administrator account to log in:
    login: admin
    password: admin
    
-7. Go to "Administration" to load the default configuration data (roles, 
+   Go to "Administration" to load the default configuration data (roles, 
    trackers, statuses, workflow) and adjust application settings
 
 
-== SMTP server Configuration
-
-In config/environment.rb, you can set parameters for your SMTP server:
-config.action_mailer.smtp_settings: SMTP server configuration
-config.action_mailer.perform_deliveries: set to false to disable mail delivering
+== Email delivery Configuration
 
+Copy config/email.yml.example to config/email.yml and edit this file
+to adjust your SMTP settings.
 Don't forget to restart the application after any change to this file.
+
+Please do not enter your SMTP settings in environment.rb.