Redmine: Difference between revisions
From Andreida
(10 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 == |
|||
⚫ | |||
=== new variant with backport for redmine === |
|||
* Install imagemagick |
|||
apt-get install imagemagick |
|||
<span style="color: Red"> TEST: IN PROGRESS </span> |
|||
⚫ | |||
* install the Postgre database: |
* install the Postgre database: |
||
apt-get install postgresql postgresql-contrib |
apt-get install postgresql postgresql-contrib |
||
Line 31: | Line 27: | ||
* install redmine main part |
* install redmine main part |
||
aptitude install redmine |
aptitude install redmine |
||
* answer twice with 'y' |
|||
* install Redmine Postgres package |
* install Redmine Postgres package |
||
aptitude install redmine-pgsql |
aptitude install redmine-pgsql |
||
Line 38: | Line 34: | ||
* install Redmine for real |
* install Redmine for real |
||
aptitude install redmine |
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 |
* disable writing to /var/www for others than root |
||
chmod o-w /var/www |
chmod o-w /var/www |
||
* copy |
* copy the following files (don't know if all are needed) |
||
cd /etc/apache2/sites-available |
cd /etc/apache2/sites-available |
||
cp /usr/share/doc/redmine/examples/apache2-host.conf . |
cp /usr/share/doc/redmine/examples/apache2-host.conf . |
||
Line 56: | Line 52: | ||
ln -s ../sites-available/apache2-passenger-alias.conf |
ln -s ../sites-available/apache2-passenger-alias.conf |
||
ln -s ../sites-available/apache2-passenger-host.conf |
ln -s ../sites-available/apache2-passenger-host.conf |
||
* restart Apache |
|||
⚫ | |||
/etc/init.d/apache2 restart |
|||
⚫ | |||
⚫ | |||
⚫ | |||
** login as admin/admin |
** login as admin/admin |
||
** change your admin password |
** change your admin password (write it down) |
||
** approve the new account under "Administration/Users/All" |
** 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 88: | 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 112: | 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 133: | 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.