Cómo instalar Redmine en Debian 11 Bullseye

En este artículo vamos a ver cómo instalar Redmine en Debian 11 Bullseye paso a paso, de tal forma que en unos instantes podrás empezar a trabajar con este magnífico gestor de proyectos sobre tu servidor o VPS Debian.

Antes de instalar Redmine en Debian 11 Bullseye

Si quieres seguir los pasos de esta guía de instalación de Redmine en Debian 11 Bullseye será necesario cumplir los siguientes requisitos básicos:

En caso de no disponer del entorno necesario puede ser interesante consultar previamente nuestra guía de instalación de Apache en Debian 11, de instalación de MariaDB en Debian 11 o de instalación de PostgreSQL en Debian 11.

Cómo descargar Redmine para Debian 11

Vamos a descargar Redmine para Debian 11 Bullseye desde la sección de descargar del sitio oficial del proyecto, ya que la distribución no incluye paquetes para esta plataforma.

Encontraremos las últimas versiones estables de las ramas 4 y 5 de Redmine en paquetes con formatos .zip y .tar.gz. En este tutorial descargremos el paquete .tar.gz de la versión 5, bien desde el navegador, bien desde consola (si trabajamos remotamente) con alguna herramienta como wget:

~$ wget --no-check-certificate http://www.redmine.org/releases/redmine-5.0.1.tar.gz

Cómo instalar Redmine en Debian 11 Bullseye

Para instalar Redmine en Debian 11 Bullseye debemos realizar una serie de pasos en el orden adecuado que detallamos a continuación.

Dependencias

Redmine necesita una serie de complementos que obtendremos desde los repositorios de Debian 11 Bullseye, así que empezaremos actualizando la información de las listas de paquetes:

~$ sudo apt update

E instalamos las dependencias comunes:

~$ sudo apt install -y gcc make ruby-bundler ruby-dev zlib1g-dev libapache2-mod-passenger

Dependiendo del motor de bases de datos con el que trabajemos necesitaremos instalar adicionalmente alguna librería más.

En el caso de MariaDB:

~$ sudo apt install -y libmariadb-dev

Si se trata de MySQL:

~$ sudo apt install -y default-libmysqlclient-dev

Y para PostgreSQL:

~$ sudo apt install -y libpq-dev

Base de datos

Redmine puede trabajar sobre algunos de los servicios de bases de datos más usados en Debian 11 Bullseye, por lo que explicaremos cómo preparar los más utilizados.

MariaDB/MySQL

Conectamos al servicio con el cliente mysql y un usuario administrador:

~$ mysql -u root -p

Creamos la base de datos de Redmine:

> create database redmine character set utf8mb4 collate utf8mb4_unicode_ci;

Creamos el usuario:

> create user redmine@localhost identified by 'XXXXXXXX';

Damos suficientes permisos al usuario para gestionar la base de datos:

> grant all privileges on redmine.* to redmine@localhost;

Y cerramos la conexión:

> exit;

PostgreSQL

Creamos el rol para Redmine con contraseña:

~$ sudo -u postgres createuser -P redmine

Y creamos la base de datos asociándola al nuevo rol:

~$ sudo -u postgres createdb redmine -O redmine

Archivos de Redmine

Vamos a instalar el paquete que descargamos en su ubicación definitiva, así que crearemos el siguiente directorio:

~$ sudo mkdir /opt/redmine

Y descomprimimos el paquete directamente en la nueva ruta:

~$ sudo tar xf redmine-5.0.1.tar.gz -C /opt/redmine/

Se habrá creado un subdirectorio que contiene el número de la versión en su nombre. Para facilitar la configuración y mantenimiento de Redmine crearemos un enlace simbólico con un nombre más simple, sin números:

~$ sudo ln -s /opt/redmine/redmine-5.0.1/ /opt/redmine/redmine

Cambiamos el directorio de trabajo a la ruta de Redmine:

~$ cd /opt/redmine/redmine

Creamos el archivo de configuración de la conexión a la base de datos:

$ nano config/database.yml

Se trata de un archivo YAML, así que hay que usar obligatoriamente espacios en blanco en lugar de tabulaciones.

Para MariaDB/MySQL podríamos usar el siguiente contenido:

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: XXXXXXXX

Y para PostgreSQL podría ser esta la configuración:

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: XXXXXXXX

Hemos especificado la base de datos, el usuario y la clave tal como los creamos en pasos anteriores.

Guardados los cambios podemos lanzar la compilación de Redmine:

$ bundle install

Algunas tareas de compilación se realizan con privilegios de sudo, así que puede que se solicite la contraseña del usuario de Debian 11 Bullseye con el que estamos trabajando.

El siguiente paso es generar la clave con la que se cifran las cookies de Redmine:

$ bundle exec rake generate_secret_token

Inicializamos la base de datos:

$ RAILS_ENV=production bundle exec rake db:migrate

Y la cargamos con los datos por defecto:

$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Este comando solicitará el idioma en el que queremos que se carguen los datos, a partir de una lista mostrada en consola. Para el español podemos indicar «es«.

Prueba de funcionamiento

Ya podemos realizar una prueba de conexión a Redmine con el servidor de consola incluido.

Si pensamos acceder desde red y estamos usando el firewall UFW habrá que añadir la correspondiente regla para el puerto 3000/TCP

$ sudo ufw allow 3000/tcp

Lanzamos el servidor de consola para realizar la prueba:

$ bundle exec ruby /usr/local/bin/rails server -u webrick -e production

Para acceder desde un navegador construiremos una URL con la dirección del servidor (IP, dominio, nombre DNS, localhost si trabajamos localmente, etc.).

Por ejemplo, la máquina Debian 11 sobre la que hemos preparado este tutorial es accesible en el subdominio debian11.local.lan, así que accederíamos a la prueba con http://debian11.local.lan:3000 como URL:

En consola se irá mostrando información relacionada con la actividad de la aplicación.

Terminaremos la prueba y liberaremos la consola con la combinación de teclas Control-C.

Ya podemos abandonar el directorio de Redmine:

$ cd

Servicio web

Editaremos el archivo del módulo Passenger del servicio web para que trabaje con el usuario adecuado:

~$ sudo nano /etc/apache2/mods-available/passenger.conf

Dentro del bloque IfModule añadiremos la directiva PassengerUser con el usuario con el que corre el servicio web:

<IfModule mod_passenger.c>
...
        PassengerUser www-data
</IfModule>

Guardamos el archivo y cambiamos el propietario de los archivos de Redmine al mismo usuario:

~$ sudo chown -R www-data: /opt/redmine/redmine/

Ajustamos los permisos de estos archivos para el grupo y resto de usuarios con valores seguros:

~$ sudo chmod -R 755 /opt/redmine/redmine/{files,log,tmp,public/plugin_assets}

Creamos un enlace a la aplicación web de Redmine desde el directorio de archivos web del sitio por defecto:

~$ sudo ln -s /opt/redmine/redmine/public/ /var/www/html/redmine

Editamos la configuración del sitio web por defecto:

~$ sudo nano /etc/apache2/sites-available/000-default.conf

Y añadimos la configuración necesaria para que el servicio web trate de forma adecuada los archivos de Redmine como aplicación:

<VirtualHost *:80>
...
        <Location /redmine>
                RailsEnv production
                RackBaseURI /redmine
                Options -MultiViews
        </Location>
...
</VirtualHost>

Guardamos los cambios y aplicamos todos estos ajustes recargando la configuración del servicio:

~$ sudo systemctl reload apache2

Accediendo a Redmine

Ya está todo listo para acceder a Redmine sobre Debian 11 Bullseye desde un navegador, para lo que añadiremos la ruta /redmine a la dirección del servidor.

Siguiendo con el ejemplo de este tutorial, ahora sería http://debian11.local.lan/redmine la URL de acceso.

Se mostrará la página principal de Redmine.

Podemos iniciar sesión visitando el enlace «Iniciar sesión» del menú superior:

Podemos iniciar sesión con el usuario administrador admin y su clave admin.

Inmediatamente Redmine nos obligará a cambiar la contraseña por defecto del usuario:

Introducimos la contraseña actual, la nueva contraseña y su confirmación.

La contraseña queda modificada y se nos redirige a la página de perfil del usuario con el que hemos iniciado la sesión:

Ahora ya podemos empezar a trabajar con nuestra nueva instancia de Redmine sobre Debian 11 Bullseye.

Conclusión

Ahora que ya sabes cómo instalar Redmine en Debian 11 Bullseye vas a poder trabajar con este gran gestor y administrador de proyectos tanto en ámbito de red local como desde Internet.

En caso de dudas, preguntas, sugerencias, notificación de errores, etc. puedes dejar un comentario. Los comentarios están moderados (para evitar el SPAM), pero se revisan prácticamente a diario.

Y si ya funciona esta plataforma sobre tu máquina gracias a nuestra guía y quiere agradecérnoslo, cualquier mínima aportación contribuye mucho al mantenimiento de este sitio y la creación de más artículos y tutoriales.

Puedes ayudarnos dejando una propina de tan solo 1 $ desde PayPal:

¡Gracias!