¿Cómo instalar Ruby on Rails en tu computadora? | Ruby on Rails Básico

Instalar Ruby on Rails significa preparar tu computadora con tres herramientas principales: Ruby, la gema Rails, y una base de datos.

¿Sabías que la mayoría de los principiantes abandona Rails antes de escribir una sola línea de código? No porque sea difícil, sino porque la instalación les genera errores que no saben resolver. Hoy vas a evitar eso.

El equipo que necesitas antes de empezar

No necesitas una computadora cara. Necesitas una computadora con sistema operativo actualizado.

Las opciones más comunes son macOS, Linux (Ubuntu o Fedora) y Windows. Linux y macOS son los favoritos de los desarrolladores Rails en México porque tienen menos fricciones. Windows funciona, pero requiere un paso extra: instalar WSL2 (Windows Subsystem for Linux).

Si tienes Windows 10 u 11, activa WSL2 desde la terminal con el comando wsl --install. Después de reiniciar, tendrás Ubuntu dentro de Windows. Desde ahí, sigue los mismos pasos que en Linux.

La historia de Carlos: el error que lo frenó dos días

Carlos tiene 24 años y trabaja en soporte técnico para una empresa de logística en Monterrey. Gana $14,500 al mes y quiere aprender Rails para cambiar de área.

Descargó Ruby directamente del sitio oficial. Lo instaló. Instaló Rails. Todo parecía bien... hasta que su proyecto no arrancó. El error decía algo sobre versiones incompatibles.

¿Qué pasó? Carlos instaló Ruby sin usar un gestor de versiones. Eso es el error más común en toda la comunidad Rails. La solución es instalar primero una herramienta llamada rbenv (o su alternativa, RVM).

¿Qué es rbenv y por qué lo necesitas?

rbenv es un gestor de versiones de Ruby. Te permite tener varias versiones de Ruby en tu computadora y cambiar entre ellas fácilmente.

Imagina que un proyecto de tu empresa usa Ruby 3.1 y otro usa Ruby 3.2. Sin rbenv, tendrías que desinstalar y reinstalar Ruby cada vez. Con rbenv, cambias con un solo comando.

Además, rbenv aísla tus proyectos. Lo que instales en un proyecto no afecta a otro. Eso evita exactamente el error que tuvo Carlos.

Instalación paso a paso en macOS o Linux

Paso 1: Instala las dependencias del sistema

En Ubuntu o Debian, abre tu terminal y escribe:

sudo apt update
sudo apt install -y git curl libssl-dev libreadline-dev zlib1g-dev build-essential

En macOS, instala primero Homebrew (si no lo tienes):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Paso 2: Instala rbenv

En Linux o macOS con Homebrew:

brew install rbenv ruby-build

O en Linux directamente:

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

Paso 3: Instala Ruby con rbenv

Primero revisa las versiones disponibles:

rbenv install --list

Luego instala la versión estable más reciente (por ejemplo, 3.2.2):

rbenv install 3.2.2
rbenv global 3.2.2

Verifica que quedó bien:

ruby -v

Deberías ver algo como: ruby 3.2.2. Si lo ves, ¡Ruby está listo!

Paso 4: Instala Rails

Rails se instala como una gema (así se llaman las librerías en Ruby):

gem install rails

Espera unos minutos. Cuando termine, verifica:

rails -v

Deberías ver: Rails 7.x.x. Si aparece un número, lo lograste.

Paso 5: Instala Node.js y Yarn

Rails necesita JavaScript para algunas funciones del frontend. Instala Node.js:

brew install node yarn

En Ubuntu:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
npm install --global yarn

Crea tu primer proyecto Rails

Ya tienes todo instalado. Ahora viene la parte emocionante.

Navega a la carpeta donde guardas tus proyectos. Por ejemplo:

cd ~/Documentos/proyectos

Crea tu primer proyecto con este comando:

rails new mi_primera_app

Rails va a crear una carpeta llamada mi_primera_app con docenas de archivos ya organizados. Eso es la magia del framework: no empiezas desde cero.

Entra a la carpeta y arranca el servidor:

cd mi_primera_app
rails server

Abre tu navegador y visita: http://localhost:3000

Verás la pantalla de bienvenida de Rails. Un fondo oscuro con el logotipo. Esa pantalla significa que todo funciona. ¡Felicidades!

La historia de Valeria: de contadora a desarrolladora junior

Valeria trabajaba en el área de finanzas de una distribuidora en Puebla. Su sueldo era de $12,000 al mes. Quería más.

Siguió exactamente estos pasos en su laptop con Ubuntu. La instalación le tomó 40 minutos, incluyendo las descargas. Cuando vio la pantalla de bienvenida de Rails, le tomó una foto y la mandó a su grupo de amigos.

Seis meses después, Valeria consiguió su primer trabajo como desarrolladora junior en una startup de tecnología educativa. Su nuevo sueldo: $22,000 al mes. La instalación fue el primer paso real.

Errores comunes y cómo resolverlos

Incluso siguiendo las instrucciones, a veces algo falla. Aquí están los problemas más frecuentes:

Error: Command not found: rails Esto pasa cuando rbenv no está bien configurado en tu terminal. Solución: cierra tu terminal, ábrela de nuevo, y ejecuta rbenv rehash. Si persiste, revisa que el comando eval "$(rbenv init -)" esté en tu archivo .bashrc o .zshrc.

Error: Gem::FilePermissionError Significa que estás intentando instalar gemas con permisos de administrador sin rbenv. Nunca uses sudo gem install. Solución: asegúrate de estar usando la versión de Ruby de rbenv con which ruby. Debe mostrar una ruta dentro de .rbenv, no /usr/bin/ruby.

Error: Could not find a JavaScript runtime Rails necesita Node.js. Solución: instala Node.js con el Paso 5 de arriba.

Error en Windows: Encoding o caracteres extraños Esto pasa cuando el nombre de tu carpeta o usuario tiene acentos o espacios. Solución: crea tu proyecto en una ruta simple como C:\proyectos\mi_app.

El servidor arranca pero el navegador no abre nada Revisa que estés visitando http://localhost:3000 y no https://. Rails por defecto no usa HTTPS en desarrollo.

¿SQLite, PostgreSQL o MySQL?

Rails usa una base de datos para guardar información. Por defecto, usa SQLite. Eso está perfecto para aprender.

Cuando trabajes en proyectos reales, como una app para una tienda tipo Liverpool o un sistema para una empresa como FEMSA, usarás PostgreSQL. Es más robusto y es el estándar en producción.

Por ahora, no cambies nada. SQLite viene incluido y no necesitas instalar nada extra. Más adelante en este curso aprenderás a configurar PostgreSQL.

Tu entorno está listo

Instalaste rbenv, Ruby, Rails, Node.js y creaste tu primer proyecto. Eso ya te pone por delante de muchos que nunca llegan a este punto.

En la próxima lección vas a explorar la estructura de carpetas que Rails creó. Vas a entender para qué sirve cada carpeta y cómo Rails organiza tu código desde el principio.

Recuerda: Carlos perdió dos días por saltarse el gestor de versiones. Tú no cometiste ese error. Eso ya es una ventaja real.

Antes de continuar, confirma estos tres puntos:

ruby -v muestra una versión 3.x
rails -v muestra una versión 7.x
http://localhost:3000 muestra la pantalla de bienvenida de Rails

Si los tres puntos están bien, estás listo para la siguiente lección.