Panduan instalasi Ruby on Rails di Windows untuk pemula

 Panduan instalasi Ruby on Rails di Windows untuk pemula

Kita akan menyiapkan lingkungan coding dari nol menggunakan Windows 10/11 + Ruby + Ruby on Rails + PostgreSQL + VS Code. Di akhir panduan, kamu akan menjalankan aplikasi web pertamamu di browser.

Ruby + DevKit

Bahasa pemrograman dan alat untuk membangun beberapa library native.

Ruby on Rails

Framework untuk membuat aplikasi web.

PostgreSQL

Database untuk menyimpan data aplikasi.

Visual Studio Code

Editor untuk menulis dan mengelola kode.

Kita akan menggunakan instalasi Ruby native di Windows agar langkah awalnya mudah diikuti. RubyInstaller menyediakan Ruby beserta DevKit untuk pengembangan di Windows.

rubyinstaller.org

+1

1. Download tools yang diperlukan

Buka tautan resmi berikut untuk mengunduh setiap aplikasi.

Ruby + DevKit

Pilih installer 64-bit (x64) yang menyertakan DevKit.

Download RubyInstaller 

PostgreSQL

Database server untuk aplikasi Rails.

Download PostgreSQL 

Visual Studio Code

Editor kode.

Download VS Code 

Git for Windows

Version control untuk menyimpan riwayat perubahan kode.

Download Git 

Catatan: Untuk Ruby, pilih paket Ruby+Devkit x64. Saat ini halaman RubyInstaller merekomendasikan seri Ruby 4.0.x untuk pengguna baru. Jika proyek atau tutorial yang akan kamu ikuti mengharuskan Ruby 3.4.x, pilih versi tersebut agar sesuai dengan persyaratan proyek.

rubyinstaller.org

2. Install Ruby + DevKit

Estimasi: 5–15 menit, tergantung koneksi internet.

1. Buka halaman RubyInstaller Downloads .

2. Download installer Ruby+Devkit x64 yang sesuai dengan versi yang dipilih.

3. Jalankan file .exe, ikuti instruksi installer, dan gunakan pengaturan default kecuali kamu punya kebutuhan khusus.

4. Di akhir instalasi, jika muncul terminal MSYS2, tekan Enter untuk menjalankan instalasi komponen yang direkomendasikan. Tunggu sampai selesai.

5. Buka menu Start Windows dan cari Start Command Prompt with Ruby. Kamu juga bisa membuka terminal baru setelah instalasi.

RubyInstaller menyediakan MSYS2/DevKit untuk membantu proses kompilasi gem yang membutuhkan komponen native.

rubyinstaller.org

+1

Sekarang cek apakah Ruby berhasil dipasang:

bash

ruby -v
gem -v
ridk version

Jika setiap perintah menampilkan informasi versi atau instalasi, lanjutkan ke langkah berikutnya.

3. Install Git

Jalankan installer Git yang sudah diunduh. Untuk pemula, kamu bisa menggunakan pengaturan default.

Setelah selesai, tutup lalu buka terminal baru dan jalankan:

bash

git --version

Jika muncul versi Git, berarti instalasi berhasil.

4. Install PostgreSQL

1. Buka Download PostgreSQL for Windows  dan ikuti tautan installer Windows.

2. Jalankan installer. Pilih komponen PostgreSQL Server dan Command Line Tools. pgAdmin boleh ikut dipasang untuk mengelola database dengan antarmuka grafis.

3. Saat diminta membuat password untuk pengguna database postgres, buat password yang kuat dan simpan password tersebut. Kamu akan memerlukannya untuk menghubungkan Rails ke database.

4. Gunakan port default 5432, kecuali port itu sudah digunakan aplikasi lain.

5. Selesaikan instalasi dan pastikan service PostgreSQL berjalan melalui aplikasi Services di Windows.

Verifikasi PostgreSQL

Buka terminal baru, lalu jalankan:

bash

psql --version

Jika perintah tidak dikenali, kemungkinan folder bin PostgreSQL belum masuk ke PATH Windows. Foldernya biasanya berbentuk seperti:

text

C:\Program Files\PostgreSQL\<versi>\bin

Tambahkan folder tersebut ke Environment Variables → Path, lalu buka terminal baru.

Berikutnya, coba login ke database:

bash

psql -U postgres -h localhost

Masukkan password PostgreSQL saat diminta. Jika berhasil, kamu akan masuk ke prompt postgres=#. Ketik \q untuk keluar.

5. Install Ruby on Rails

Sekarang kita memasang Rails melalui RubyGems.

Buka terminal Ruby yang sudah disiapkan dan jalankan:

bash

gem install rails

Tunggu sampai selesai. Proses ini bisa memakan waktu beberapa menit.

Periksa hasilnya:

bash

rails --version
bundle --version

gem install rails memasang framework Rails, sedangkan Bundler digunakan untuk mengelola dependency proyek.

Jika rails tidak dikenali, tutup terminal lalu buka kembali. Pastikan ruby -v juga berfungsi.

Panduan resmi Rails tersedia di Ruby on Rails Documentation .

Ruby on Rails

+1

6. Install Visual Studio Code

1. Install VS Code dari website resminya .

2. Buka VS Code, lalu pilih menu Extensions menggunakan ikon kotak di sisi kiri.
3. Cari ekstensi Ruby yang menyediakan syntax highlighting dan dukungan bahasa Ruby. Pilih ekstensi yang sesuai dengan kebutuhanmu.

4. Buka terminal VS Code melalui menu Terminal → New Terminal.

Cek bahwa terminal VS Code bisa menjalankan:

bash

ruby -v
rails --version
git --version

Kalau ketiganya berfungsi, kamu siap membuat proyek.

7. Buat proyek Rails pertama dengan PostgreSQL

Kita akan membuat aplikasi bernama belajar_rails.

A. Pilih folder proyek

Di terminal, jalankan:

powershell

cd $HOME\Documents
mkdir projects
cd projects

Jika folder projects sudah ada, cukup masuk ke folder itu dengan cd projects.

B. Generate aplikasi

Jalankan:

bash

rails new belajar_rails --database=postgresql

Perintah ini membuat struktur aplikasi Rails dengan PostgreSQL sebagai database. Rails juga akan memasang dependency yang dibutuhkan.

Ruby on Rails Guides

Tunggu hingga proses selesai. Jika berhasil, masuk ke folder aplikasi:

bash

cd belajar_rails

Buka folder tersebut di VS Code:

bash

code .

Jika perintah code tidak dikenali, buka VS Code secara manual, lalu pilih File → Open Folder dan pilih folder belajar_rails.

C. Konfigurasikan koneksi database

Di VS Code, buka file:

config/database.yml

Periksa bagian development dan pastikan konfigurasi koneksinya sesuai dengan PostgreSQL lokalmu. Contohnya:

yaml

development:
  adapter: postgresql
  encoding: unicode
  host: localhost
  port: 5432
  username: postgres
  password: <%= ENV["POSTGRES_PASSWORD"] %>
  pool: 5

Jangan mengganti seluruh file secara membabi buta. Pertahankan konfigurasi lain yang dibuat Rails, dan sesuaikan bagian koneksi yang diperlukan.

Untuk contoh di atas, pada terminal PowerShell yang sama, masukkan password PostgreSQL yang kamu buat saat instalasi:

powershell

$env:POSTGRES_PASSWORD = "password_postgres_kamu"

Ganti teks tersebut dengan password lokalmu sendiri. Ini hanya berlaku untuk sesi terminal itu; jangan menyimpan password asli di repository Git.

D. Siapkan database aplikasi

Pastikan service PostgreSQL aktif. Dari terminal di folder belajar_rails, jalankan:

bash

bin/rails db:prepare

Perintah ini menyiapkan database yang diperlukan aplikasi. Jika berhasil, Rails sudah bisa berkomunikasi dengan PostgreSQL.

8. Jalankan aplikasi Rails

Masih di folder proyek yang sama, jalankan:

bash

bin/rails server

Jika berhasil, terminal akan menampilkan informasi server yang berjalan di port 3000.

Buka browser dan akses:

Aplikasi Rails lokal

Klik alamat berikut untuk membuka aplikasi.

http://localhost:3000 

Kamu seharusnya melihat halaman awal Ruby on Rails. Selamat, aplikasi pertamamu sudah berjalan!

Untuk menghentikan server, kembali ke terminal lalu tekan Ctrl + C.

9. Checklist instalasi

Gunakan checklist berikut untuk memastikan setiap tahap sudah selesai.

Progress instalasi

0 dari 8

Ruby dan DevKit terpasang

Git terpasang

PostgreSQL aktif dan password tersimpan

Rails berhasil di-install

VS Code dapat menjalankan perintah Ruby

Proyek belajar_rails berhasil dibuat

Database berhasil disiapkan

Halaman localhost:3000 berhasil dibuka

10. Jika terjadi error

Error	Yang perlu diperiksa
ruby is not recognized	PATH Ruby dan terminal setelah instalasi
rails is not recognized	Instalasi gem Rails dan PATH Ruby
connection refused	Service PostgreSQL, host, dan port 5432
password authentication failed	Username dan password database
database does not exist	Jalankan bin/rails db:prepare
Instalasi gem pg gagal	Versi Ruby, DevKit, dan kompatibilitas gem