Cómo instalar y configurar Ruby en Ubuntu con rbenv

Ruby es un lenguaje elegante, expresivo y muy usado en desarrollo web gracias a Ruby on Rails. Si trabajas en múltiples proyectos, necesitas gestionar diferentes versiones de Ruby. Para eso está rbenv: una herramienta ligera y flexible que facilita su instalación y gestión.

Table of Contents

🔧 ¿Qué necesitas?

• Ubuntu 18.04+ o WSL en Windows 10/11
• Conexión a internet
• Permisos sudo
• Git instalado

1. Actualiza tu sistema y dependencias

sudo apt update && sudo apt upgrade -y && sudo apt full-upgrade -y

Luego instala las herramientas necesarias:

sudo apt install -y \
git-core curl wget build-essential libssl-dev libreadline-dev \
zlib1g-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev \
libxslt1-dev libcurl4-openssl-dev software-properties-common \
libffi-dev libgdbm-dev libncurses5-dev automake libtool bison \
libvips imagemagick ffmpeg poppler-utils mupdf mupdf-tools

2. Instala rbenv

git clone https://github.com/rbenv/rbenv.git ~/.rbenv

3. Configura tu entorno

Agrega estas líneas a tus archivos de entorno ~/.bashrc, ~/.zshrc, ~/.profile o ~/.zprofile, según tu shell:

# Configuración de rbenv
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"

Luego ejecuta:

exec "$SHELL"

4. Instala ruby-build (plugin de rbenv)

git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build

5. Verifica versiones disponibles

rbenv install --list

Deberías ver una lista de versiones de Ruby disponibles. Elige la versión que necesites (por ejemplo 3.4.4).

6. Instala Ruby

Para instalar Ruby, usa el comando:

rbenv install 3.4.4

Luego, establece la versión instalada como global:

rbenv global 3.4.4

Verifica con:

ruby -v

Deberías ver algo como:

ruby 3.4.4 (2025-05-14 revision a38531fd3f) +PRISM [arm64-darwin24]

7. Instala Bundler y RubyGems

gem install bundler
gem update --system

8. (Opcional) Configura Bundler para usar HTTPS

bundle config github.https true

🛠️ ¿Problemas comunes?

rbenv no se reconoce

Revisa que hayas agregado correctamente las líneas en ~/.zprofile o ~/.bashrc.

Error de compilación

Instala dependencias faltantes:

sudo apt install -y libssl-dev zlib1g-dev

🔄 Actualiza rbenv y ruby-build

cd ~/.rbenv && git pull
cd "$(rbenv root)"/plugins/ruby-build && git pull

🚀 Conclusión

Ahora tienes un entorno Ruby totalmente funcional y mantenible con rbenv.

✅ Puedes:

• Instalar múltiples versiones de Ruby
• Alternar entre ellas
• Actualizar fácilmente

📚 Recursos adicionales

• Cómo configurar tu entorno de desarrollo en Ubuntu
• Cómo instalar y configurar Git en Ubuntu y WSL
• Documentación oficial de rbenv
• Documentación oficial de ruby-build