Instalasi #

Ruby tersedia di semua sistem operasi utama, tapi cara instalasi yang paling tepat bergantung pada sistem kamu dan bagaimana kamu berencana menggunakannya. Ada perbedaan mendasar antara menginstal Ruby untuk satu proyek kecil versus mengelola banyak proyek yang masing-masing membutuhkan versi Ruby yang berbeda. Memahami perbedaan ini sebelum mulai menginstal akan menghemat banyak waktu dan frustrasi di kemudian hari. Artikel ini membahas semua metode instalasi yang umum digunakan — mulai dari yang paling sederhana hingga yang paling fleksibel — beserta kapan kamu sebaiknya memilih satu metode dibanding yang lain.

Memilih Metode Instalasi yang Tepat #

Sebelum masuk ke langkah-langkah teknis, penting untuk memahami perbedaan antara dua pendekatan instalasi Ruby: instalasi langsung ke sistem dan instalasi menggunakan version manager.

INSTALASI LANGSUNG (RubyInstaller / Homebrew / APT / YUM):
  ✓ Lebih sederhana, cocok untuk belajar dan eksplorasi awal
  ✓ Tidak perlu memahami konsep version management
  ✓ Cukup untuk satu proyek atau satu versi Ruby
  ✗ Sulit menjalankan dua proyek yang butuh versi Ruby berbeda
  ✗ Upgrade versi Ruby bisa bermasalah jika tidak hati-hati
  ✗ Tidak direkomendasikan untuk lingkungan produksi

INSTALASI VIA VERSION MANAGER (RVM / rbenv):
  ✓ Bisa menginstal dan beralih antar banyak versi Ruby
  ✓ Setiap proyek bisa terisolasi ke versi tertentu
  ✓ Standar industri untuk developer Ruby profesional
  ✓ Memudahkan kolaborasi karena versi bisa di-lock per proyek
  ✗ Sedikit lebih kompleks untuk setup awal
  ✗ Butuh pemahaman dasar tentang PATH dan shell configuration

Jika kamu baru belajar Ruby dan belum yakin ingin serius menggunakannya, instalasi langsung sudah cukup. Tapi jika kamu berencana mengerjakan proyek nyata — terutama Ruby on Rails — langsung gunakan version manager sejak awal. Migrasi dari instalasi langsung ke RVM atau rbenv di kemudian hari lebih merepotkan dari yang dibayangkan.

Instalasi Ruby di Windows #

Windows bukan platform utama untuk pengembangan Ruby, tapi ekosistemnya sudah cukup matang berkat RubyInstaller. Ada dua jalur: menggunakan RubyInstaller yang berjalan langsung di Windows, atau menggunakan WSL (Windows Subsystem for Linux) yang memberikan lingkungan Linux penuh di dalam Windows.

Menggunakan RubyInstaller #

RubyInstaller adalah cara tercepat untuk memulai Ruby di Windows. Installer ini sudah menyertakan semua dependensi yang dibutuhkan termasuk kompiler C yang diperlukan untuk menginstal beberapa gem native.

Langkah 1 — Unduh RubyInstaller

Kunjungi rubyinstaller.org dan pilih versi yang sesuai. Kamu akan melihat dua varian: Ruby dan Ruby+Devkit. Untuk pengembangan aplikasi yang akan menggunakan gem dengan ekstensi native (seperti Nokogiri atau pg), pilih Ruby+Devkit karena sudah menyertakan MSYS2 dan kompiler yang diperlukan.

Panduan memilih versi di RubyInstaller:

  Ruby (x64)          → Hanya interpreter Ruby
  Ruby+Devkit (x64)   → Ruby + MSYS2 + build tools (DIREKOMENDASIKAN)

Pilih versi dengan label "(RECOMMENDED)" jika ada — biasanya
versi minor terbaru dari rilis stable.

Langkah 2 — Jalankan Installer

Setelah file .exe terunduh, klik dua kali untuk menjalankannya. Ikuti wizard instalasi dengan memperhatikan satu hal penting:

□ Centang opsi: "Add Ruby executables to your PATH"
□ Centang opsi: "Associate .rb and .rbw files with this Ruby installation"

Jangan lewatkan centang PATH — tanpanya, kamu harus mengetik path lengkap setiap kali menjalankan perintah Ruby di terminal.

Langkah 3 — Instal MSYS2 dan Toolchain (khusus Ruby+Devkit)

Setelah installer selesai, sebuah jendela Command Prompt akan terbuka secara otomatis menanyakan apakah kamu ingin menginstal MSYS2. Tekan Enter atau ketik 1 untuk menginstal toolchain standar — ini diperlukan untuk mengompilasi gem native.

# Jika jendela tidak muncul otomatis, jalankan:
ridk install

Pilih opsi 1 (MSYS2 base installation) atau 3 (MSYS2 and MINGW development toolchain) untuk instalasi lengkap.

Langkah 4 — Verifikasi Instalasi

Buka Command Prompt baru (penting: bukan yang lama, karena perubahan PATH baru aktif di session baru) dan jalankan:

ruby -v
gem -v
irb --version

Output yang diharapkan:

ruby 3.3.x (2024-xx-xx revision xxxxxxxx) [x64-mingw-ucrt]
3.x.x
irb x.x.x (2024-xx-xx)

Menggunakan Windows Subsystem for Linux (WSL) #

WSL adalah pilihan yang lebih baik jika kamu berencana serius mengembangkan aplikasi Ruby, terutama Ruby on Rails. Lingkungan Linux yang kamu dapatkan dari WSL jauh lebih kompatibel dengan tooling Ruby modern dibandingkan Windows native.

Kapan pilih WSL dibanding RubyInstaller:
  ✓ Berencana mengerjakan proyek Ruby on Rails
  ✓ Ingin menggunakan rbenv atau RVM
  ✓ Tim kamu menggunakan Linux atau macOS
  ✓ Akan deploy ke server Linux
  ✗ Hanya ingin belajar Ruby dasar secara cepat

Langkah 1 — Aktifkan WSL

Buka PowerShell sebagai Administrator (klik kanan > “Run as Administrator”) dan jalankan:

wsl --install

Perintah ini mengaktifkan WSL dan menginstal Ubuntu secara otomatis. Restart komputer setelah proses selesai.

Langkah 2 — Setup Ubuntu

Setelah restart, Ubuntu akan terbuka dan meminta kamu membuat username dan password. Gunakan username dan password yang mudah kamu ingat — ini berbeda dari akun Windows kamu.

Langkah 3 — Instal Ruby di WSL

Setelah berada di dalam terminal Ubuntu WSL, ikuti langkah instalasi untuk Linux di bagian selanjutnya. Semua perintah Linux berlaku di sini.

Jangan simpan file proyek Ruby kamu di dalam filesystem Windows (/mnt/c/Users/...) jika menggunakan WSL. Performa I/O antara WSL dan filesystem Windows sangat lambat dan akan menyebabkan perintah seperti bundle install atau rails server terasa lambat sekali. Simpan proyek di dalam home directory WSL (~/projects/) untuk performa optimal.

Instalasi Ruby di macOS #

macOS sudah menyertakan Ruby bawaan, tapi jangan gunakan Ruby sistem ini untuk pengembangan. Ruby sistem digunakan oleh macOS sendiri untuk beberapa skrip internal, dan memodifikasi atau menginstall gem ke Ruby sistem bisa menyebabkan masalah yang tidak terduga pada sistem operasi kamu.

JANGAN gunakan Ruby bawaan macOS untuk pengembangan:
  ✗ /usr/bin/ruby      → Ruby sistem, milik macOS
  ✗ /usr/local/bin/ruby → Bisa menimpa instalasi sistem

GUNAKAN salah satu dari ini:
  ✓ Homebrew → /opt/homebrew/bin/ruby  (untuk Apple Silicon)
  ✓ RVM      → ~/.rvm/rubies/ruby-x.x.x/bin/ruby
  ✓ rbenv    → ~/.rbenv/versions/x.x.x/bin/ruby

Menggunakan Homebrew #

Homebrew adalah manajer paket yang paling umum digunakan di macOS. Instalasi Ruby via Homebrew cepat dan mudah, cocok sebagai titik awal.

Langkah 1 — Instal Homebrew

Jika Homebrew belum ada, buka Terminal dan jalankan:

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

Proses ini akan meminta password administrator kamu dan menginstal Xcode Command Line Tools jika belum ada. Ikuti semua instruksi yang muncul di layar.

Setelah selesai, jika kamu menggunakan Mac dengan chip Apple Silicon (M1/M2/M3), tambahkan Homebrew ke PATH dengan menjalankan perintah yang ditampilkan di akhir instalasi. Biasanya seperti ini:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Langkah 2 — Instal Ruby

brew install ruby

Setelah instalasi selesai, Homebrew akan menampilkan pesan bahwa Ruby tidak di-link secara otomatis karena bentrok dengan Ruby bawaan macOS. Tambahkan Ruby Homebrew ke PATH secara manual:

# Untuk Apple Silicon (M1/M2/M3):
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc

# Untuk Intel Mac:
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc

# Aktifkan perubahan:
source ~/.zshrc

Langkah 3 — Verifikasi Instalasi

which ruby    # Harus menampilkan path Homebrew, bukan /usr/bin/ruby
ruby -v
gem -v

Menggunakan RVM di macOS #

RVM (Ruby Version Manager) memungkinkan kamu menginstal dan beralih antar banyak versi Ruby. Ini adalah pilihan yang lebih baik jika kamu berencana mengerjakan beberapa proyek Ruby dengan kebutuhan versi yang berbeda.

Langkah 1 — Instal GPG Key

RVM memverifikasi paketnya menggunakan GPG. Instal kunci publik RVM terlebih dahulu:

gpg --keyserver keyserver.ubuntu.com --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Langkah 2 — Instal RVM

\curl -sSL https://get.rvm.io | bash -s stable

Perhatikan backslash (\) sebelum curl — ini mencegah penggunaan alias curl jika ada. Setelah instalasi, muat RVM ke session terminal:

source ~/.rvm/scripts/rvm

Atau tutup terminal dan buka yang baru.

Langkah 3 — Instal Ruby via RVM

Lihat versi Ruby yang tersedia:

rvm list known

Instal versi Ruby yang kamu inginkan:

# Instal versi terbaru:
rvm install ruby

# Atau instal versi spesifik:
rvm install 3.3.0

# Set sebagai default:
rvm use 3.3.0 --default

Langkah 4 — Verifikasi

ruby -v
rvm list        # Lihat semua versi Ruby yang terinstal
rvm current     # Versi yang sedang aktif

Instalasi Ruby di Linux #

Linux adalah platform utama untuk pengembangan Ruby, terutama untuk aplikasi server. Setiap distribusi Linux memiliki package manager yang berbeda, tapi pilihan paling fleksibel tetap menggunakan RVM atau rbenv.

Menggunakan APT (Debian/Ubuntu) #

APT adalah cara tercepat untuk menginstal Ruby di Debian, Ubuntu, Linux Mint, dan distribusi berbasis Debian lainnya.

Langkah 1 — Update Repository

Selalu update daftar paket sebelum menginstal:

sudo apt update && sudo apt upgrade -y

Langkah 2 — Instal Dependensi

Ruby membutuhkan beberapa library untuk dikompilasi dan dijalankan dengan benar:

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

Langkah 3 — Instal Ruby

sudo apt install -y ruby-full

Flag ruby-full menginstal interpreter Ruby beserta library standar yang lengkap, bukan hanya versi minimal.

Langkah 4 — Konfigurasi Gem untuk User Lokal

Secara default, gem install di Linux membutuhkan sudo untuk menulis ke direktori sistem. Konfigurasikan Gem agar menginstal ke direktori home kamu:

echo '# Gem path configuration' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/.gem"' >> ~/.bashrc
echo 'export PATH="$HOME/.gem/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Langkah 5 — Verifikasi

ruby -v
gem -v
gem environment  # Lihat konfigurasi lengkap Gem

Menggunakan YUM/DNF (CentOS/RHEL/Fedora) #

Untuk distribusi berbasis Red Hat seperti Fedora, CentOS, Rocky Linux, dan AlmaLinux.

Instal Dependensi Build:

# Fedora / CentOS 8+ / RHEL 8+ / Rocky Linux / AlmaLinux:
sudo dnf install -y gcc make openssl-devel readline-devel \
  zlib-devel libffi-devel git curl

# CentOS 7 / RHEL 7:
sudo yum install -y gcc make openssl-devel readline-devel \
  zlib-devel libffi-devel git curl

Instal Ruby:

# Fedora / CentOS 8+ / RHEL 8+:
sudo dnf install -y ruby ruby-devel rubygems

# CentOS 7 / RHEL 7:
sudo yum install -y ruby ruby-devel rubygems

Versi Ruby yang tersedia di repository YUM/DNF sering kali tertinggal beberapa versi dari release terbaru. Misalnya, CentOS 7 menyertakan Ruby 2.0 yang sudah sangat usang. Untuk versi Ruby yang lebih baru di sistem RHEL-based, gunakan RVM atau rbenv, atau aktifkan Software Collections (SCL) jika tersedia di distribusi kamu.

Verifikasi:

ruby -v
gem -v

Menggunakan RVM di Linux #

RVM di Linux bekerja dengan cara yang sama seperti di macOS. Ini adalah pilihan yang direkomendasikan untuk developer yang bekerja dengan beberapa proyek Ruby.

Langkah 1 — Instal Dependensi

# Ubuntu/Debian:
sudo apt install -y curl gnupg2

# Fedora/CentOS/RHEL:
sudo dnf install -y curl gnupg2

Langkah 2 — Import GPG Key

gpg --keyserver keyserver.ubuntu.com --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Langkah 3 — Instal RVM

\curl -sSL https://get.rvm.io | bash -s stable

Setelah selesai, muat RVM ke session:

source ~/.rvm/scripts/rvm

Atau tambahkan ke .bashrc / .zshrc agar otomatis dimuat setiap kali buka terminal:

echo 'source ~/.rvm/scripts/rvm' >> ~/.bashrc
source ~/.bashrc

Langkah 4 — Instal Ruby

# Instal versi terbaru:
rvm install ruby

# Atau versi spesifik:
rvm install 3.3.0

# Jadikan default:
rvm use 3.3.0 --default

# Verifikasi:
ruby -v
rvm list

Menggunakan rbenv #

rbenv adalah alternatif yang lebih ringan dari RVM. Berbeda dari RVM yang menggunakan shell function untuk beralih versi, rbenv bekerja dengan memanipulasi PATH. Pengguna yang lebih menyukai pendekatan yang transparan dan minimal sering memilih rbenv.

Perbandingan RVM vs rbenv:

Fitur                    RVM         rbenv
─────────────────────────────────────────
Ukuran instalasi         Besar       Kecil
Cara kerja               Shell fn    PATH shims
Gemset terpisah          ✓           ✗ (pakai bundler)
Dukungan .ruby-version   ✓           ✓
Kompleksitas             Sedang      Rendah
Komunitas                Besar       Besar

Langkah 1 — Instal rbenv

curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-installer | bash

Script ini menginstal rbenv beserta plugin ruby-build yang diperlukan untuk mengunduh dan mengompilasi versi Ruby.

Langkah 2 — Konfigurasi Shell

Tambahkan rbenv ke PATH dan inisialisasi:

# Untuk Bash:
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
source ~/.bashrc

# Untuk Zsh:
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc

Verifikasi rbenv terkonfigurasi dengan benar:

rbenv doctor

Output yang diharapkan:

Checking for `rbenv' in PATH: /home/user/.rbenv/bin/rbenv
Checking for rbenv shims in PATH: OK
Checking `rbenv install' support: /home/user/.rbenv/plugins/ruby-build/bin/rbenv-install (ruby-build x.x.x)
Counting installed Ruby versions: none
  There aren't any Ruby versions installed under `/home/user/.rbenv/versions'.
  You can install Ruby versions like so: rbenv install 3.3.0
Auditing installed plugins: OK

Langkah 3 — Instal Ruby

Lihat semua versi Ruby yang tersedia:

rbenv install --list          # Versi stable terbaru
rbenv install --list-all      # Semua versi termasuk preview

Instal versi yang diinginkan:

rbenv install 3.3.0

Proses ini mengunduh source code Ruby dan mengompilasinya dari scratch — bisa memakan waktu beberapa menit tergantung spesifikasi mesin kamu.

Langkah 4 — Set Versi Ruby

# Set global (default untuk semua proyek):
rbenv global 3.3.0

# Set lokal (hanya untuk direktori saat ini dan sub-direktorinya):
cd ~/projects/my-app
rbenv local 3.2.0   # Membuat file .ruby-version di direktori ini

Langkah 5 — Verifikasi

ruby -v
rbenv versions       # Semua versi yang terinstal
rbenv version        # Versi yang sedang aktif
which ruby           # Harus menunjuk ke shim rbenv

Verifikasi Instalasi yang Komprehensif #

Setelah menginstal Ruby dengan metode apapun, lakukan verifikasi menyeluruh untuk memastikan semuanya berjalan dengan benar.

# 1. Cek versi Ruby
ruby -v

# 2. Cek versi Gem (package manager Ruby)
gem -v

# 3. Cek versi Bundler (dependency manager untuk proyek)
bundler -v    # Atau: bundle -v

# 4. Jalankan kode Ruby sederhana dari command line:
ruby -e 'puts "Ruby berjalan dengan baik!"'

# 5. Buka IRB (Interactive Ruby), ketik kode, tekan Enter:
irb

Di dalam IRB, coba beberapa perintah:

# Tes dasar
puts "Halo dari Ruby!"
2 + 2
"Ruby".upcase
[1, 2, 3].map { |n| n * 2 }

Diagram alur verifikasi:

flowchart TD
    A[Selesai Instal] --> B{ruby -v berhasil?}
    B -- Tidak --> C[Cek PATH konfigurasi]
    C --> D[Tambahkan Ruby ke PATH]
    D --> E[Restart terminal]
    E --> B
    B -- Ya --> F{gem -v berhasil?}
    F -- Tidak --> G[Instal ulang Ruby dengan flag ruby-full]
    G --> F
    F -- Ya --> H{IRB bisa dibuka?}
    H -- Ya --> I[✓ Instalasi berhasil]
    H -- Tidak --> J[Cek readline library]
    J --> K[sudo apt install libreadline-dev]
    K --> H

Menginstal Bundler #

Setelah Ruby terinstal, instal Bundler. Bundler adalah dependency manager untuk proyek Ruby dan hampir selalu dibutuhkan, terutama untuk Ruby on Rails.

gem install bundler

Verifikasi:

bundler -v

Bundler membaca file Gemfile di direktori proyek kamu untuk menginstal semua dependensi yang dibutuhkan proyek tersebut. Ini adalah alat yang kamu akan gunakan setiap kali memulai proyek Ruby baru.

Mengelola Versi Ruby di Proyek #

Jika kamu menggunakan RVM atau rbenv, kamu bisa mengunci versi Ruby yang digunakan oleh setiap proyek menggunakan file .ruby-version.

# Di direktori proyek:
echo "3.3.0" > .ruby-version

# rbenv akan otomatis mendeteksi file ini
# RVM juga mendukung format yang sama

Cara ini penting untuk kolaborasi tim — semua developer akan menggunakan versi Ruby yang sama secara otomatis.

sequenceDiagram
    participant Dev as Developer
    participant Shell as Shell
    participant rbenv as rbenv/RVM
    participant Ruby as Ruby Binary

    Dev->>Shell: cd my-project/
    Shell->>rbenv: Baca .ruby-version
    rbenv->>Shell: Aktifkan Ruby 3.3.0
    Dev->>Shell: ruby script.rb
    Shell->>Ruby: Jalankan dengan Ruby 3.3.0
    Ruby-->>Dev: Output program

Memperbarui Ruby #

Cara memperbarui Ruby bergantung pada metode instalasi yang kamu gunakan.

Menggunakan RVM:

# Update list versi yang tersedia:
rvm get stable

# Instal versi baru:
rvm install 3.4.0

# Migrasi gem dari versi lama:
rvm upgrade 3.3.0 3.4.0

# Set sebagai default:
rvm use 3.4.0 --default

Menggunakan rbenv:

# Update ruby-build untuk mendapat versi terbaru:
cd ~/.rbenv/plugins/ruby-build && git pull

# Instal versi baru:
rbenv install 3.4.0

# Set global:
rbenv global 3.4.0

# Atau update per proyek:
rbenv local 3.4.0

Menggunakan Homebrew:

brew upgrade ruby

Menggunakan APT:

sudo apt update && sudo apt upgrade ruby

Setelah upgrade versi Ruby menggunakan rbenv atau RVM, gem yang kamu install di versi lama tidak otomatis tersedia di versi baru. Kamu perlu menjalankan bundle install kembali di setiap proyek untuk menginstal ulang semua dependensi di versi Ruby yang baru. Ini adalah perilaku yang diinginkan karena memastikan setiap versi Ruby punya set gem yang bersih dan terisolasi.

Ringkasan #

Pilih metode berdasarkan kebutuhan — RubyInstaller untuk Windows pemula, Homebrew untuk macOS cepat, APT/YUM untuk satu-proyek di Linux, dan RVM/rbenv untuk pengembangan profesional yang butuh banyak versi.
Jangan gunakan Ruby sistem di macOS — /usr/bin/ruby milik sistem operasi, bukan untuk development. Selalu instal Ruby terpisah.
RVM dan rbenv adalah standar industri — jika berencana mengerjakan proyek Ruby serius, langsung setup version manager sejak hari pertama.
File .ruby-version untuk kolaborasi tim — buat file ini di root proyek agar seluruh tim menggunakan versi Ruby yang sama secara otomatis.
Instal Bundler segera setelah Ruby — hampir semua proyek Ruby menggunakannya, termasuk Ruby on Rails.
Konfigurasi GEM_HOME di Linux — agar gem install tidak membutuhkan sudo dan gem terinstal di direktori home kamu.
Verifikasi dengan ruby -v, gem -v, dan IRB — tiga perintah ini sudah cukup untuk memastikan instalasi berjalan dengan benar.
Update ruby-build secara berkala — jika menggunakan rbenv, plugin ruby-build perlu di-update agar bisa menginstal versi Ruby terbaru.

← Sebelumnya: Pengenalan Berikutnya: Sintaks Utama →