Project

General

Profile

HowTo Install Redmine using Debian package » History » Version 8

Piotr Serwa, 2011-02-09 03:02

1 1 Jérémy Lal
h1. HowTo Install Redmine using Debian package
2
3
A redmine debian package is available in squeeze, sid and "lenny-backports":http://backports.org/dokuwiki/doku.php?id=instructions
4
Featuring:
5
* automatic database configuration,
6
* multiple instances support.
7
8
The core package is redmine.
9
Three packages (redmine-*) provide correct dependencies for mysql, pgsql, sqlite.
10
11
Currently there is no plugins support, although it's on the way.
12 2 Piotr Serwa
13
14
h1. Installation details
15
16 3 Piotr Serwa
h2. Install the necessary packages 
17 2 Piotr Serwa
18 3 Piotr Serwa
From root console:
19 1 Jérémy Lal
20 3 Piotr Serwa
@apt-get install mysql@
21
during mysql setup, provide a new root password for mysql
22 1 Jérémy Lal
23 3 Piotr Serwa
@apt-get install redmine@
24
during redmine install, select mysql database with local connection, set the admin password for redmine_default database
25 2 Piotr Serwa
26 3 Piotr Serwa
@apt-get install libapache2-mod-passenger@
27 2 Piotr Serwa
28 3 Piotr Serwa
29
h2. Do some configuration
30
31 1 Jérémy Lal
@ln -s /usr/share/redmine/public /var/www/redmine@
32 2 Piotr Serwa
@chown -R www-data:www-data /var/www/redmine@
33
@echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine@
34
@a2ensite redmine@
35
@/etc/init.d/apache2 reload@
36
@/etc/init.d/apache2 restart@
37
38 4 Piotr Serwa
h2. Configure email smtp server
39
40
Copy from template:
41
@cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/mail.yml@
42
43 5 Piotr Serwa
Edit (at the end, there are uncommented production / development blocks to be filled in):
44 4 Piotr Serwa
@vi /etc/redmine/default/mail.yml@
45
46 3 Piotr Serwa
h2. Run the browser
47
48
Open http://localhost/redmine
49 4 Piotr Serwa
50 1 Jérémy Lal
Log in as admin / admin
51 6 Piotr Serwa
52
h2. Futher configuration - SVN
53
54 7 Piotr Serwa
Get the API key (settings / repositories)
55 1 Jérémy Lal
56 8 Piotr Serwa
Make a crontab to have repositories generated in the background: 
57
58
@crontab -e@
59
60
In the editor, paste the following:
61 7 Piotr Serwa
@5 * * * * /usr/bin/ruby /usr/share/redmine/extra/svn/reposman.rb --redmine localhost/redmine --svn-dir /usr/home/svn --owner www-data --group www-data --url file:///usr/home/svn --verbose --key=YOUR_API_KEY_HERE--command="/usr/bin/svnadmin create" >> /var/log/reposman.log@
62 6 Piotr Serwa
63
Configure servername/svn, so that svn repositories are available over apache webdav:
64
fixme