Cómo instalar Redmine en Ubuntu 18.04 LTS

En este artículo explicamos cómo instalar Redmine en Ubuntu 18.04 LTS paso a paso, en su última versión disponible, de modo que al final del tutorial podrás trabajar con esta aplicación de planificación de proyectos sobre tu servidor o VPS Ubuntu.

Antes de instalar Redmine en Ubuntu 18.04 LTS

Si quieres completar hasta el final esta guía de instalación de Redmine en Ubuntu 18.04 LTS debes satisfacer una serie de requerimientos:

  • Una máquina Ubuntu 18.04 LTS actualizada.
  • Un entorno o pila tipo LAMP.
  • Acceso a consola con un usuario con permisos de sudo.
  • Conexión a Internet.

En este tutorial asumimos Apache como servidor web. Si usas MariaDB, no sirve la versión de los repositorios de Ubuntu 18.04, se necesita una versión más actualizada, como indicamos en la guía de instalación de MariaDB en Ubuntu 18.04.

Cómo descargar Redmine para Ubuntu 18.04 LTS

Vamos a descargar Redmine para Ubuntu 18.04 LTS desde la web oficial del proyecto:

como descargar redmine para ubuntu 18.04 lts

En la sección «Download» encontraremos los paquetes de las últimas ramas de Redmine en distitos formatos:

descargar redmine para ubuntu 18.04 lts

En este tutorial copiaremos el enlace del paquete .tar.gz de la última versión para descargarlo desde consola con wget:

~$ wget https://www.redmine.org/releases/redmine-4.0.5.tar.gz

Cómo instalar Redmine en Ubuntu 18.04 LTS

Para instalar Redmine en Ubuntu 18.04 LTS necesitamos realizar una serie de tareas en el orden adecuado, que detallamos a continuación:

Archivos de Redmine

Empezamos creando un directorio donde ubicar Redmine:

~$ sudo mkdir /opt/redmine

Descomprimimos el paquete de Redmine que acabamos de descargar en el directorio que hemos creado:

~$ sudo tar xzf redmine-4.0.5.tar.gz -C /opt/redmine/

Requisitos previos

Para compilar Redmine y sus dependencias necesitamos asegurarnos de disponer de ciertas herramientas en el sistema. Como siempre, hay que empezar actualizando las listas de paquetes de los repositorios:

~$ sudo apt update

Ahora instalamos los requisitos:

~$ sudo apt install -y build-essential gem libapache2-mod-passenger libmagickwand-dev rails ruby-bundler ruby-dev

Si la base de datos que usamos es MariaDB, necesitamos sus librerías de desarrollo:

~$ sudo apt install -y libmariadbclient-dev-compat

Si usamos MySQL serán estas:

~$ sudo apt install -y libmysqlclient-dev

Preparativos de la base de datos

Vamos a crear la base de datos y el usuario para Redmine. Podemos usar el cliente de consola mysql con el usuario que utilicemos para administrar habitualmente:

~$ mysql -u root -p

Creamos la base de datos:

> create database redmine;

Si usamos MySQL 5.x ó MariaDB creamos el usuario sin mayor complicación:

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

Pero si usamos MySQL 8.x tenemos que asegurarnos de crear el usuario con el plugin de autenticación adecuado:

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

En cualquier caso, concedemos al usuario los permisos sobre la base de datos:

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

Ya podemos cerrar el cliente y regresar a consola:

> exit

Redmine

Creamos el archivo de configuración de Redmine para la conexión con la base de datos, database.yml:

~$ sudo nano /opt/redmine/redmine-4.0.5/config/database.yml

En esta configuración usaremos los datos que acabamos de crear:

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

Cambiamos el directorio de trabajo al directorio de Redmine:

~$ cd /opt/redmine/redmine-4.0.5/

Ejecutaremos bundle para descargar e instalar las dependencias de Redmine:

$ bundle install

Durante el proceso se nos pedirá nuestra contraseña de usuario para que bundle pueda realizar ciertas tareas con sudo.

Generamos el token para cifrar las cookies de sesión:

$ bundle exec rake generate_secret_token

Creamos la estructura de la base de datos:

$ RAILS_ENV=production bundle exec rake db:migrate

Por último poblaremos la base con datos iniciales:

$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Se nos preguntará en qué idioma cargar los datos, en este ejemplo para seleccionar el español contestamos es.

Es el momento de comprobar que todo funciona con un test:

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

Quedará en ejecución el servidor de prueba, esperando conexiones en el puerto 3000 TCP, sin devolver el control a la consola y mostrando un registro de eventos a medida que sucedan.

Si quieres realizar una conexión de prueba desde otra máquina de la red y tienes el firewall UFW activado, añade la regla necesaria:

~$ sudo ufw allow 3000/tcp

Ya podemos introducir en el navegador la dirección IP, nombre de máquina o dominio de la máquina Ubuntu 18.04, añadiendo el puerto 3000:

como instalar redmine en ubuntu 18.04 lts

La prueba funciona perfectamente, así que podemos detener el servidor de prueba con Control-C y recuperar la consola de nuevo.

Configuración del servidor web

Cambiamos la propiedad de los archivos de Redmine al usuario y grupo con el que corre el servicio web en Ubuntu 18.04 (www-data para Apache):

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

Adecuamos los permisos para que sólo el servidor web pueda escribir:

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

Creamos un enlace simbólico desde el directorio de documentos del servidor web al directorio de documentos de Redmine:

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

Para configurar el módulo Passenger de Apache, editamos su archivo de configuración:

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

Añadimos la directiva PassengerUser:

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

Sólo queda configurar el sitio web principal de Ubuntu 18.04 para configurar la ruta /redmine, para lo que editamos su archivo de configuración:

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

Añadimos un bloque Directory dentro del bloque VirtualHost:

...
        <Directory /var/www/html/redmine>
                RailsEnv production
                RailsBaseURI /redmine
                PassengerResolveSymlinksInDocumentRoot on
                Options -MultiViews
        </Directory>
...

Finalmente, reiniciamos el servidor web:

~$ sudo systemctl restart apache2

Acceder a Redmine en Ubuntu 18.04 LTS

Está todo listo para probar Redmine en Ubuntu 18.04. Accedemos desde el navegador indicando como URL la dirección IP, nombre de máquina o dominio añadiendo la ruta /redmine. Por ejemplo, la máquina en la que hemos realizado este tutorial es accesible en el dominio ubuntu64.local, así que podemos usar http://ubuntu64.local/redmine como URL:

instalar redmine en ubuntu 18.04 lts

¡Listo para trabajar!

Puedes iniciar sesión con el usuario admin y la clave temporal admin. Una vez que accedemos a Redmine tendremos que cambiar la contraseña temporal por una definitiva, tras lo cual se nos presentará la página de configuración del perfil del usuario administrador, para poder personaliza los datos:

redmine en ubuntu 18.04 lts

Ya está la aplicación lista para empezar a trabajar con proyectos y usuarios.

Conclusión

Si has llegado hasta aquí, ya sabes cómo instalar Redmine en Ubuntu 18.04 LTS, toda una travesía para disfrutar de esta aplicación, que no debería faltar en ningún entorno de equipos de desarrollo.

En caso de dudas, preguntas, sugerencias, etc. puedes dejar un comentario.

¡Apoya este sitio!

¿Ya tienes la aplicación funcionando gracias a esta guía de instalación de Redmine en Ubuntu 18.04 LTS? Si es así y te apetece agradecérnoslo, cualquier mínima aportación ayuda al mantenimiento de este sitio y creación de nuevos tutoriales de Ubuntu 18.04 y Redmine. ¡Gracias!

Valora esta entrada

1 estrella2 estrellas3 estrellas4 estrellas5 estrellas (1 votos, promedio: 5,00 de 5)
Cargando…

Deja un comentario

Este sitio web utiliza cookies para que usted tenga la mejor experiencia de usuario. Si continúa navegando está dando su consentimiento para la aceptación de las mencionadas cookies y la aceptación de nuestra política de cookies.

ACEPTAR
Aviso de cookies