Redmine: Difference between revisions

From Andreida
No edit summary
 
(17 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
* 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
* 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 28: 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 52: 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 73: 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

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".

(source)

Redmine inside VirtualBox

If you are running Redmine inside a VirtualBox you might want to have a look here: Port forwarding for Redmine.