From DreamHost

This article describes how to install Redmine, an integrated Wiki and Issue Tracker with support for Subversion. These instructions assume you will be doing this on a shared host (DreamHost).

Installation

For help on using the shell you can take a look at the UNIX commands and you can also get help on changing directories.

If you want to save the output for debugging and support then you can look at the Redirection Symbol.

Instructions

From Alan Daveline’s Blog About Everything

  1. From the Dreamhost control panel, create a new subdomain for the application such as yoursubdomain.yourdomain.com
        1. Make sure the domain supports “Ruby on Rails Passenger (mod_rails)?”
        2. Specify your web directory: /home/username/yoursubdomain.yourdomain.com/public
               * you must add the public!!!
  2. From the Dreamhost control panel create a new MySQL database named yourdatabasename
  3. ssh into your Dreamhost account
  4. cd ~/yoursubdomain.yourdomain.com
  5. svn export --force svn://rubyforge.org/var/svn/redmine/branches/0.7-stable ./
         * check http://www.redmine.org/wiki/redmine/Download for the latest version
  6. also watch out for permissions
         * chmod -v -R 755 ./*
  7. cd ~/yoursubdomain.yourdomain.com/config
  8. cp database.yml.example database.yml
  9. nano database.yml
        1. edit the database.yml config file with the appropriate info. Should be similar to the following
           production:
           adapter: mysql
           database: yourdatabasename
           username: yourusername
           password: yourpassword
           host: mysql.yourdomain.com
 10. cd ~/yoursubdomain.yourdomain.com/public
 11. cp dispatch.rb.example dispatch.rb
 12. nano .htaccess (replace with following text)
     Options +FollowSymLinks +ExecCGI
     RewriteEngine On
     RewriteRule ^$ index.html [QSA]
     RewriteRule ^([^.]+)$ $1.html [QSA]
     RewriteCond %{REQUEST_FILENAME} !-f
     ErrorDocument 500 "H2Application errorH2 Rails application failed to start properly"
         * replace the H2 with the proper HTML tag when you place it in the .htaccess
 13. cd ~/yoursubdomain.yourdomain.com
 14. from application root type
         * rake db:migrate RAILS_ENV="production"
 15. also type the following to load config defaults
         * rake redmine:load_default_data RAILS_ENV="production"
         * choose "en" for english
 16. browse to http://yoursubdomain.yourdomain.com

Sending Email

From Matt Jones' Blog

In order to get Redmine to send emails, you will need to update config/environment.rb

Find the following code:

	# SMTP server configuration
	config.action_mailer.smtp_settings = {
		:address => "127.0.0.1",
		:port => 25,
		:domain => "somenet.foo",
		:authentication => :login,
		:user_name => "redmine@somenet.foo",
		:password => "redmine",
	}
	
	config.action_mailer.perform_deliveries = true

	# Tell ActionMailer not to deliver emails to the real world.
	# The :test delivery method accumulates sent emails in the
	# ActionMailer::Base.deliveries array.
	#config.action_mailer.delivery_method = :test
	config.action_mailer.delivery_method = :smtp  

Update the domain, user_name and password values if using SMTP.

To use Sendmail, change the above code to:

	# SMTP server configuration
	config.action_mailer.smtp_settings = {
		:address => "127.0.0.1",
		:port => 25,
		:domain => "yourdomain",
		:authentication => :plain,
	}
	
	config.action_mailer.perform_deliveries = true

	# Tell ActionMailer not to deliver emails to the real world.
	# The :test delivery method accumulates sent emails in the
	# ActionMailer::Base.deliveries array.
	#config.action_mailer.delivery_method = :test
	config.action_mailer.delivery_method = :sendmail  

Don't forget to restart Passenger by adding the file restart.txt to the tmp folder.

Features

• Bug and Feature Tracker
• Wiki
• MySQL, PostgreSQL support
• Unicode Support
• Svn, git, mercurial, bazzaar repository support.

Link a new repository

When a new project is made you will probably link a repository to it. Go to the project. Then settings -> repository -> Create. Choose the repository type and enter its full local path. For example, for git:

 /home/username/repodict/.git

It is important to tell Redmine to look for new repositories. Execute this line:

 ruby /home/username/sub.domain.com/script/runner "Repository.fetch_changesets" -e  production

Change production for any envirorment you made.

Logging In

Username: admin Password: admin

Please login and change the administrator password as soon as possible

Alternative Packages

Bugzilla

Mantis is a PHP bug tracker

Trac