Nivel inicial5 min de lectura · Publicado el

Instalar Ruby y Ruby on Rails en Ubuntu con rbenv

Instalar Ruby en Ubuntu con rbenv: un llavero con Ruby 3.4.12 para un proyecto, con rbenv local, y 4.0.9 para todo el sistema. Cada proyecto, su Rubyrubentejera.com rbenvproyectosistemarbenv local 3.4.12rbenv global 4.0.9
rbenv es el llavero: guarda varias versiones de Ruby sin que se pisen. rbenv global 4.0.9 es la llave de todo el sistema y rbenv local 3.4.12, la que usa solo la carpeta del proyecto antiguo.

La manera más sencilla de instalar Ruby en Ubuntu es con apt, pero no instala la última versión: en Ubuntu 26.04 el paquete ruby trae Ruby 3.3, cuando la última estable es la 4.0.

Por eso conviene un gestor de versiones. Es como tener varias llaves en el llavero y elegir cuál usar en cada puerta: puedes tener Ruby 3.4 para un proyecto antiguo y Ruby 4.0 para uno nuevo, sin que se pisen. Aquí usamos rbenv.

Si todavía no sabes qué es Ruby ni para qué se usa, échale un vistazo antes de instalarlo.

  1. Instala las dependencias para compilar Ruby.
  2. Instala rbenv.
  3. Instala ruby-build.
  4. Instala Ruby y fíjalo como versión global.
  5. Opcional: instala Rails y crea una aplicación.

1. Dependencias

rbenv no descarga Ruby ya hecho: lo compila en tu equipo. Para eso necesita Git y las librerías de compilación:

sudo apt update
sudo apt install -y git curl build-essential autoconf libssl-dev libyaml-dev zlib1g-dev libffi-dev libgmp-dev rustc

Es la lista mínima que recomienda ruby-build para la última versión estable. rustc sirve para activar YJIT, el compilador que acelera Ruby.

2. Instalar rbenv

Clona el repositorio en tu carpeta personal:

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

Y deja que rbenv configure tu terminal:

~/.rbenv/bin/rbenv init

Este comando añade a tu ~/.bashrc la línea que carga rbenv. Antes había que añadir a mano el PATH y el eval "$(rbenv init -)"; ya no hace falta.

Cierra la terminal y abre otra (o ejecuta source ~/.bashrc). Comprueba que funciona:

type rbenv

Si responde que rbenv es una función, está listo. A continuación muestra su código; así salía en la versión original del artículo, con el sistema en español:

rbenv: es una función
rbenv () 
{ 
    local command;
    command="${1:-}";
    if [ "$#" -gt 0 ]; then
        shift;
    fi;
    case "$command" in 
        rehash | shell)
            eval "$(rbenv "sh-$command" "$@")"
        ;;
        *)
            command rbenv "$command" "$@"
        ;;
    esac
}

3. Instalar ruby-build

ruby-build es el plugin de rbenv que aporta el comando rbenv install, el que descarga, compila e instala cada versión de Ruby:

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

Listar versiones disponibles

rbenv install -l    # la última de cada serie
rbenv install -L    # todas

Actualizar rbenv y ruby-build

Cuando salga una versión nueva de Ruby y no aparezca en la lista, actualiza los dos repositorios:

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

4. Instalar Ruby en Ubuntu con rbenv

Instala la última versión (en noviembre de 2026, la 4.0.9) y fíjala como versión global del sistema:

rbenv install 4.0.9
rbenv global 4.0.9
ruby -v
# ruby 4.0.9 (2026-10-23 revision 3e93b23afc) +PRISM [x86_64-linux]

La compilación tarda unos minutos.

Si un proyecto necesita otra versión, entra en su carpeta y usa rbenv local 3.4.12: rbenv crea un fichero .ruby-version y usará esa versión solo ahí.

Sin documentación al instalar gemas

Las gemas son librerías de Ruby listas para usar. Para que no descarguen su documentación al instalarlas, y ahorrar tiempo y espacio:

echo "gem: --no-document" > ~/.gemrc

Ya puedes escribir tu primer programa: Hola Mundo en Ruby.

Un gestor de versiones: cada proyecto, con su Ruby.

5. Instalar Ruby on Rails en Ubuntu

Rails es el framework web más conocido de Ruby. Se instala como una gema más:

gem install rails
rails -v
# Rails 8.1.4.1

Antes había que instalar también Bundler, la herramienta que gestiona las gemas de cada proyecto. Desde Ruby 2.6 viene incluida: compruébalo con bundle -v.

Rails usa SQLite como base de datos por defecto. Si al crear la aplicación falla la gema sqlite3, instala sus librerías de desarrollo:

sudo apt install -y libsqlite3-dev

Crear y arrancar una aplicación

mkdir ~/Sites && cd ~/Sites
rails new test-project
cd test-project
bin/rails server

Abre localhost:3000 en el navegador y verás la página de bienvenida de Rails:

Navegador en localhost:3000 con la página de bienvenida Yay! You're on Rails!, Rails 5.2.0 y Ruby 2.5.1

La captura es de 2018, con Rails 5.2; en Rails 8 la página de bienvenida tiene otro diseño. Para parar el servidor, pulsa Ctrl + C.

Para seguir con la aplicación, tienes Crear y arrancar un nuevo proyecto en Ruby on Rails.

Fuentes

Ejecutado en un contenedor ubuntu:26.04 (Ubuntu 26.04.1 LTS) de Docker: dependencias (más algunas opcionales de ruby-build y libsqlite3-dev), rbenv desde Git, rbenv init, ruby-build, rbenv install -l, rbenv install 4.0.9 (unos 4 minutos), rbenv global, gem install rails (Rails 8.1.4.1, Bundler 4.0.20 ya incluido) y rails new test-project. El arranque del servidor en el navegador solo se ha comprobado en la guía de Rails. El paquete ruby de Ubuntu 26.04 (3.3) se ha consultado con apt-cache policy.