Redmine: Difference between revisions
From Andreida
(16 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
* Debian 8 - Jessie <span style="color: Red"> (Currently - 2022-11-27 - no Redmine support for Debian 11!) </span> |
|||
* If you are using a VM, give it at least 256 MB. |
* If you are using a VM, give it at least 256 MB. |
||
== Redmine, new variant for installation with backport == |
|||
== get it going == |
|||
* [[Using_a_backport|add the backport repository]] and "apt-get update" but don't install anything yet |
|||
=== new variant with svn for redmine === |
|||
* Install imagemagick |
|||
(todo) |
|||
apt-get install imagemagick |
|||
* install the Postgre database: |
|||
apt-get install postgresql postgresql-contrib |
|||
* Check the output for the start command, something like |
|||
pg_ctlcluster 13 main start |
|||
* Either use this or just reboot the machine |
|||
* Check the status of the database (replace the cluster 13 with yours) |
|||
pg_ctlcluster 13 main status |
|||
* A good answer is: |
|||
server is running |
|||
* Install Apache 2 |
|||
apt-get install apache2 libapache2-mod-fcgid libapache2-mod-passenger |
|||
* enable mod rewrite.load |
|||
cd /etc/apache2/mods-enabled |
|||
ln -s ../mods-available/rewrite.load |
|||
* disable default site |
|||
cd /etc/apache2/sites-enabled |
|||
rm * |
|||
* install Aptitude |
|||
apt-get install aptitude |
|||
* install redmine main part |
|||
aptitude install redmine |
|||
* answer twice with 'y' |
|||
* install Redmine Postgres package |
|||
aptitude install redmine-pgsql |
|||
* enable writing to /var/www for others than root |
|||
chmod o+w /var/www |
|||
* install Redmine for real |
|||
aptitude install redmine |
|||
* Accept this solution: n (no) |
|||
* Accept this solution: y (yes) |
|||
* Accept this solution: y (yes) |
|||
* Answer all questions with the default (yes/localhost/empty) |
|||
* disable writing to /var/www for others than root |
|||
chmod o-w /var/www |
|||
* copy the following files (don't know if all are needed) |
|||
cd /etc/apache2/sites-available |
|||
cp /usr/share/doc/redmine/examples/apache2-host.conf . |
|||
cp /usr/share/doc/redmine/examples/apache2-alias.conf . |
|||
cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf . |
|||
cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf . |
|||
* enable the config files |
|||
cd /etc/apache2/sites-enabled |
|||
ln -s ../sites-available/apache2-host.conf |
|||
ln -s ../sites-available/apache2-alias.conf |
|||
ln -s ../sites-available/apache2-passenger-alias.conf |
|||
ln -s ../sites-available/apache2-passenger-host.conf |
|||
* restart Apache |
|||
/etc/init.d/apache2 restart |
|||
* visit your site |
|||
** create a new account, which will be pending approval (write it down too) |
|||
** login as admin/admin |
|||
** change your admin password (write it down) |
|||
** approve the new account under "Administration/Users/Status:All" |
|||
== old variant with apt-get for redmine == |
|||
* install required packages |
* install required packages |
||
apt-get install apache2 libapache2-mod-fcgid mysql-server libapache2-mod-passenger |
apt-get install apache2 libapache2-mod-fcgid mysql-server libapache2-mod-passenger |
||
Line 33: | Line 86: | ||
** change your admin password |
** change your admin password |
||
== mail == |
== mail (not tested with Debian 11 so far) == |
||
* Make your server being able to send mails: |
* Make your server being able to send mails: |
||
Line 57: | Line 110: | ||
* Change admin email |
* Change admin email |
||
== subversion == |
== subversion (not tested with Debian 11 so far) == |
||
If you are using a custom ssl-certificate, you will perhaps get problems. |
If you are using a custom ssl-certificate, you will perhaps get problems. |
||
One way to fix this: |
One way to fix this: |
||
Line 78: | Line 131: | ||
* don't allow login for www-data in /etc/passwd |
* don't allow login for www-data in /etc/passwd |
||
www-data:x:33:33:www-data:/var/www:/usr/sbin/nologin |
www-data:x:33:33:www-data:/var/www:/usr/sbin/nologin |
||
== Misc (after installation) == |
|||
=== Issues for Gantt chart === |
|||
<pre> |
|||
It only displays "issues that have a start date and a due date or are assigned to a version with a date". |
|||
</pre> |
|||
[https://www.redmine.org/issues/4018 (source)] |
|||
=== Redmine inside VirtualBox === |
|||
If you are running Redmine inside a VirtualBox you might want to have a look here: [http://wiki.andreas-duffner.de/index.php/VirtualBox_(Oracle)#http_example_for_Redmine_.28port_forwarding.29 Port forwarding for Redmine]. |
Latest revision as of 03:02, 8 February 2024
- If you are using a VM, give it at least 256 MB.
Redmine, new variant for installation with backport
- add the backport repository and "apt-get update" but don't install anything yet
- Install imagemagick
apt-get install imagemagick
- install the Postgre database:
apt-get install postgresql postgresql-contrib
- Check the output for the start command, something like
pg_ctlcluster 13 main start
- Either use this or just reboot the machine
- Check the status of the database (replace the cluster 13 with yours)
pg_ctlcluster 13 main status
- A good answer is:
server is running
- Install Apache 2
apt-get install apache2 libapache2-mod-fcgid libapache2-mod-passenger
- enable mod rewrite.load
cd /etc/apache2/mods-enabled ln -s ../mods-available/rewrite.load
- disable default site
cd /etc/apache2/sites-enabled rm *
- install Aptitude
apt-get install aptitude
- install redmine main part
aptitude install redmine
- answer twice with 'y'
- install Redmine Postgres package
aptitude install redmine-pgsql
- enable writing to /var/www for others than root
chmod o+w /var/www
- install Redmine for real
aptitude install redmine
- Accept this solution: n (no)
- Accept this solution: y (yes)
- Accept this solution: y (yes)
- Answer all questions with the default (yes/localhost/empty)
- disable writing to /var/www for others than root
chmod o-w /var/www
- copy the following files (don't know if all are needed)
cd /etc/apache2/sites-available cp /usr/share/doc/redmine/examples/apache2-host.conf . cp /usr/share/doc/redmine/examples/apache2-alias.conf . cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf . cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf .
- enable the config files
cd /etc/apache2/sites-enabled ln -s ../sites-available/apache2-host.conf ln -s ../sites-available/apache2-alias.conf ln -s ../sites-available/apache2-passenger-alias.conf ln -s ../sites-available/apache2-passenger-host.conf
- restart Apache
/etc/init.d/apache2 restart
- visit your site
- create a new account, which will be pending approval (write it down too)
- login as admin/admin
- change your admin password (write it down)
- approve the new account under "Administration/Users/Status:All"
old variant with apt-get for redmine
- install required packages
apt-get install apache2 libapache2-mod-fcgid mysql-server libapache2-mod-passenger
- enable mod rewrite.load
cd /etc/apache2/mods-enabled ln -s ../mods-available/rewrite.load
- install redmine
apt-get install redmine redmine-mysql
- copy some(all?) of the following files
cd /etc/apache2/sites-available cp /usr/share/doc/redmine/examples/apache2-host.conf . cp /usr/share/doc/redmine/examples/apache2-alias.conf . cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf . cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf .
- enable the config files
cd /etc/apache2/sites-enabled ln -s ../sites-available/apache2-host.conf ln -s ../sites-available/apache2-alias.conf ln -s ../sites-available/apache2-passenger-alias.conf ln -s ../sites-available/apache2-passenger-host.conf
- visit your ip
- create a new account, which will be pending approval
- login as admin/admin
- approve the new account
- change your admin password
mail (not tested with Debian 11 so far)
- Make your server being able to send mails:
dpkg-reconfigure exim4-config
- Test it with
echo bla | mail -s test you@yourDomain.com
- Get the configuration file for redmine
cd /etc/redmine/default cp /usr/share/redmine/config/configuration.yml.example ./configuration.yml
- Allow local mail delivery (do NOT use tabs, use 2 spaces)
default: email_delivery: delivery_method: :smtp
- reload apache
/etc/init.d/apache2 reload
- Change admin email
subversion (not tested with Debian 11 so far)
If you are using a custom ssl-certificate, you will perhaps get problems. One way to fix this:
- give in /etc/passwd www-data a bash:
www-data:x:33:33:www-data:/var/www:/bin/bash
- change to the user www-data
su - www-data
- provoke the question to save the certificate permanently:
svn list https://<IP>/svn/<REPOSITORY><PATH> --username <USER>
- try to save the certificate
- copy the failed path and create the directory as root
mkdir /var/www/.subversion/auth/svn.ssl.server -p
- allow the creation of files in that directory
chmod o+w /var/www/.subversion/auth/svn.ssl.server
- as www-data, try again to list the svn directory
svn list https://<IP>/svn/<REPOSITORY><PATH> --username <USER>
- save the certificate
- depending on where your server is, you will want to protect the directory again
chmod o-w /var/www/.subversion/auth/svn.ssl.server
- don't allow login for www-data in /etc/passwd
www-data:x:33:33:www-data:/var/www:/usr/sbin/nologin
Misc (after installation)
Issues for Gantt chart
It only displays "issues that have a start date and a due date or are assigned to a version with a date".
Redmine inside VirtualBox
If you are running Redmine inside a VirtualBox you might want to have a look here: Port forwarding for Redmine.