Configura GitLab en un servidor Linux: aloja tu propia plataforma DevOps

Descubre cómo instalar GitLab eficientemente en Linux para optimizar flujos DevOps y mejorar la colaboración en equipo → Más información

10 de noviembre de 20266 min de lectura2 Visitas0 útil

Introducción

GitLab es una plataforma DevOps integral que permite a los equipos colaborar en el código, automatizar flujos de trabajo y gestionar eficientemente todo el ciclo de desarrollo de software. En esta guía explicamos cómo instalar GitLab en un servidor Linux.

Instalar GitLab con One-Click Apps

Puedes instalar GitLab directamente a través de One-Click Apps en la interfaz web de VPS. Después de configurar las apps por primera vez, abre el catálogo de apps, busca GitLab y comienza el despliegue con tus ajustes preferidos de proyecto, entorno y dominio. Así podrás desplegar y administrar GitLab rápida y fácilmente, sin configuraciones manuales por línea de comandos, y disfrutarás de administración web integrada, soporte para dominios propios y provisión de SSL donde esté disponible.

Preparación

Los siguientes requisitos son recomendados por el equipo oficial de GitLab. Es muy aconsejable cumplirlos para evitar problemas y molestias posteriores.

Hardware

Componentes	Mínimo	Recomendado
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Almacenamiento	10 GB	50+ GB
Ancho de banda	100 Mbit/s (subida y bajada)	100 Mbit/s (subida y bajada)

Software

Plataforma	Opciones
Sistema operativo	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Base de datos	PostgreSQL 14.9+
Servidor web	NGINX (incluido con GitLab), Puma 6.4.2+
Otros	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Información

Para las especificaciones más actuales y precisas, consulta la documentación oficial de Requisitos de hardware de GitLab.

Para instalar GitLab en tu servidor Linux, debes conectarte mediante un cliente SSH. Consulta nuestra guía de Primer acceso (SSH).

Una vez establecida la conexión, puedes instalar los paquetes necesarios para la instalación de GitLab.

Paso 1: Instalar dependencias

Primero debes instalar algunas dependencias para que el instalador de GitLab funcione. Usa los siguientes comandos para instalar los paquetes necesarios en tu servidor Linux.

Actualiza la lista de paquetes e instala OpenSSH Server y los requisitos con este comando. Así se alojará la interfaz web de GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

Opcionalmente, puedes instalar Postfix (servidor SMTP) si quieres enviar notificaciones por correo electrónico desde GitLab.

Si deseas usar notificaciones por correo, instala Postfix con:

Code

sudo apt-get install -y postfix

Actualiza la lista de paquetes e instala OpenSSH Server y los requisitos con este comando. Así se alojará la interfaz web de GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Opcionalmente, puedes instalar Postfix (servidor SMTP) si quieres enviar notificaciones por correo electrónico desde GitLab.

Si deseas usar notificaciones por correo, instala Postfix con:

Code

sudo apt-get install -y postfix

Instala OpenSSH Server y los requisitos con este comando. Así se alojará la interfaz web de GitLab.

Code

sudo zypper install curl openssh perl

Asegúrate de que el demonio OpenSSH esté activado:

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Si usas firewalld, asegúrate de que los puertos necesarios estén abiertos.

Verifica si firewalld está activo con:

bash

sudo systemctl status firewalld

Si es así, abre los puertos estándar (80 y 443):

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Opcionalmente, puedes instalar Postfix (servidor SMTP) si quieres enviar notificaciones por correo electrónico desde GitLab.

Paso 2: Instalar GitLab

Una vez instaladas todas las dependencias, puedes instalar GitLab.

En esta guía instalamos GitLab directamente desde los repositorios oficiales.

El siguiente script añade los repositorios de GitLab al gestor de paquetes apt:

Code

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

Luego puedes instalar el paquete gitlab-ee:

bash

sudo apt-get install -y gitlab-ee

El siguiente script añade los repositorios de GitLab al gestor de paquetes Zypper:

Code

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

Luego puedes instalar el paquete gitlab-ee:

bash

sudo zypper install gitlab-ee

Al finalizar este proceso, GitLab debería estar listo para usarse en tu servidor Linux. En la siguiente sección configurarás ajustes importantes para que el servidor funcione sin problemas.

Paso 3: Configurar GitLab

Para que todo funcione, debes modificar algunos valores en el archivo de configuración. Abre el archivo de configuración de GitLab con tu editor de texto preferido. Aquí usamos como ejemplo el editor nano preinstalado.

Code

sudo nano /etc/gitlab/gitlab.rb

Busca la línea external_url e introduce tu dominio o la dirección IP de tu servidor Linux, si no quieres usar un dominio para GitLab.

Code

## URL de GitLab
##! URL donde GitLab estará accesible.
##! Para más detalles sobre la configuración de external_url, consulta:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Nota: Durante instalación/actualizaciones se usa la variable de entorno
##! EXTERNAL_URL para establecer o reemplazar este valor.
##! En instancias AWS EC2 se intenta obtener el hostname/IP público
##! de AWS. Más info:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`Tu dominio / dirección IPv4 de tu servidor Linux`'

También recomendamos introducir tu correo electrónico en la línea letsencrypt['contact_emails']. Así Let's Encrypt podrá informarte y contactarte sobre certificados SSL automáticos y gratuitos.

Información

Para un certificado SSL gratuito de Let's Encrypt necesitas un dominio. No puedes solicitar un certificado para una IP directamente.

Code

################################################################################
# Integración Let's Encrypt
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`Tu correo aquí`] # Debe ser un array de direcciones de correo
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Consulta https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically para más información
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Debe ser un número o expresión cron si se especifica.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Paso 4: Acceder a la interfaz web

Tras la inicialización, el servidor debería estar accesible desde un navegador web. Accede a tu sitio ingresando tu dominio o dirección IP:

Code

https://[tu_dominio] O BIEN http://[tu_direccion_ip]

Al acceder por primera vez verás la página de inicio de sesión.

Para el primer inicio de sesión usa el usuario root.

La contraseña está en un archivo en tu servidor Linux. Ábrelo con este comando y busca el campo Password:

Code

sudo nano /etc/gitlab/initial_root_password

Code

# ADVERTENCIA: Este valor solo es válido bajo las siguientes condiciones

# 1. Si fue establecido manualmente (ya sea vía variable de entorno `GITLAB_ROOT_PASSWORD` o configuración `gitlab_rails['initial_root_password']` en `gitlab.rb` antes de la primera carga de base de datos).

# 2. La contraseña no ha sido cambiada manualmente ni vía UI ni línea de comandos.

#

# Si la contraseña mostrada aquí no funciona, debes restablecer la contraseña de administrador: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[TU_CONTRASEÑA_AQUI]`

# NOTA: Este archivo se elimina automáticamente 24 horas después de la primera reconfiguración.

Introduce el usuario y la contraseña en la página de inicio para acceder por primera vez al panel de GitLab. Ahora deberías tener acceso a tu instancia de GitLab en tu propio servidor Linux.

Recomendamos encarecidamente crear un nuevo usuario y/o cambiar la contraseña del usuario root. Puedes hacerlo desde Admin abajo a la izquierda y luego . Allí puedes gestionar todos los usuarios de tu instancia GitLab.

Opcional: Configurar firewall con ufw

Puedes omitir este paso si no deseas configurar un firewall o si ya usas firewalld en OpenSUSE. Asegúrate de que los puertos 80/443 y 22 estén abiertos.

Instalar ufw

Si ufw ya está instalado, puedes saltarte este paso.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Abrir puertos necesarios

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Activar firewall

Atención

Por defecto ufw bloqueará todos los puertos excepto los permitidos. Asegúrate de que tu lista blanca es correcta antes de ejecutar este comando.

Activa el firewall con:

Code

sudo ufw enable

Conclusión

¡Felicidades, has instalado GitLab con éxito! Si tienes preguntas o problemas, nuestro equipo de soporte está disponible todos los días para ayudarte.

Si quieres hacer más configuraciones, te recomendamos leer la documentación oficial de GitLab para los siguientes pasos.

FAQ

Preguntas frecuentes

Puedes instalar GitLab directamente desde One-Click Apps en la interfaz web, buscando GitLab en el catálogo de apps y desplegándolo con tus ajustes preferidos de proyecto, entorno y dominio.

El mínimo es CPU 2x 2 GHz, 4 GB RAM, 10 GB de almacenamiento y 100 Mbit/s de ancho de banda. Se recomienda CPU 4x 2,6+ GHz, 8 GB RAM y más de 50 GB de almacenamiento.

GitLab es una plataforma DevOps completa que permite a los equipos colaborar en el código, automatizar flujos de trabajo y gestionar todo el ciclo de desarrollo de software eficientemente.

Comentarios

¿Te resultó útil este artículo?

Tus comentarios nos ayudan a priorizar y mejorar los contenidos.

0 de 0 Las valoraciones consideraron útil este artículo.

Ayuda personalizada

¿No te basta con la guía?

Nuestro equipo de soporte de ZAP conoce tu producto. Describe brevemente tu consulta y te ayudaremos personalmente.

Zappy conoce esta guía y te responde directamente en el chat.

## URL de GitLab ##! URL donde GitLab estará accesible. ##! Para más detalles sobre la configuración de external_url, consulta: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Nota: Durante instalación/actualizaciones se usa la variable de entorno ##! EXTERNAL_URL para establecer o reemplazar este valor. ##! En instancias AWS EC2 se intenta obtener el hostname/IP público ##! de AWS. Más info: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`Tu dominio / dirección IPv4 de tu servidor Linux`'

################################################################################ # Integración Let's Encrypt ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`Tu correo aquí`] # Debe ser un array de direcciones de correo # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Consulta https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically para más información # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Debe ser un número o expresión cron si se especifica. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

¿Qué 🍪 cookies deseas permitir?

Configura GitLab en un servidor Linux: aloja tu propia plataforma DevOps

Introducción

Instalar GitLab con One-Click Apps

Preparación

Hardware

Software

Paso 1: Instalar dependencias

Paso 2: Instalar GitLab

Paso 3: Configurar GitLab

Paso 4: Acceder a la interfaz web

Opcional: Configurar firewall con ufw

Instalar ufw

Abrir puertos necesarios

Activar firewall

Conclusión

Preguntas frecuentes

Software

Instalar GitLab con One-Click Apps

Paso 2: Instalar GitLab

Opcional: Configurar firewall con ufw

Instalar ufw

Abrir puertos necesarios

Activar firewall

Conclusión

Servidor de juego

Servidores y hosting

ZAPX

Recursos

ZAP-Hosting

Paso 1: Instalar dependencias

Paso 3: Configurar GitLab

Paso 4: Acceder a la interfaz web