rubyonrails.org에서 더 보기:

이 파일을 GITHUB에서 읽지 마세요. 가이드는 https://guides.rubyonrails.org 에서 제공됩니다.

Ruby on Rails 설치 가이드

이 가이드는 여러분의 운영체제에 Ruby 프로그래밍 언어와 Rails 프레임워크를 설치하는 과정을 안내합니다.

운영체제에 Ruby가 사전 설치되어 있을 수 있지만, 대개 오래된 버전이며 업그레이드가 불가능합니다. Mise와 같은 버전 관리자를 사용하면 최신 Ruby 버전을 설치하고, 각 앱마다 다른 Ruby 버전을 사용할 수 있으며, 새로운 버전이 출시될 때 쉽게 업그레이드할 수 있습니다.

또는 Dev Containers를 사용하여 컴퓨터에 Ruby나 Rails를 직접 설치하지 않고도 Rails를 실행할 수 있습니다. 자세한 내용은 Dev Containers 시작하기 가이드를 참조하세요.

1 운영체제 선택하기

사용하시는 운영체제에 해당하는 섹션을 따라가세요:

달러 기호 $로 시작하는 모든 명령어는 터미널에서 실행되어야 합니다.

1.1 macOS에 Ruby 설치하기

이 가이드를 따르기 위해서는 macOS Catalina 10.15 이상이 필요합니다.

macOS의 경우, Ruby를 컴파일하는데 필요한 의존성을 설치하기 위해 Xcode Command Line Tools와 Homebrew가 필요합니다.

Terminal을 열고 다음 명령어들을 실행하세요:

# Xcode Command Line Tools 설치
$ xcode-select --install

# Homebrew와 의존성 패키지 설치
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
$ echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc
$ brew install openssl@3 libyaml gmp rust

# Mise 버전 관리자 설치
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.zshrc
$ source ~/.zshrc

# Mise로 Ruby 전역 설치
$ mise use -g ruby@3

1.2 Ubuntu에 Ruby 설치

이 지침을 따르기 위해서는 Ubuntu Jammy 22.04 이상이 필요합니다.

Terminal을 열고 다음 명령어를 실행하세요:

# apt로 의존성 설치
$ sudo apt update
$ sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev

# Mise 버전 관리자 설치
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.bashrc
$ source ~/.bashrc

# Mise로 Ruby를 전역적으로 설치
$ mise use -g ruby@3

1.3 Windows에 Ruby 설치하기

Windows Subsystem for Linux(WSL)는 Windows에서 Ruby on Rails 개발을 위한 최상의 환경을 제공합니다. WSL은 Windows 내에서 Ubuntu를 실행하여 프로덕션 서버와 유사한 환경에서 작업할 수 있게 해줍니다.

Windows 11 또는 Windows 10 버전 2004 이상(Build 19041 이상)이 필요합니다.

PowerShell 또는 Windows 명령 프롬프트를 열고 다음을 실행하세요:

$ wsl --install --distribution Ubuntu-24.04

설치 과정에서 재부팅이 필요할 수 있습니다.

설치가 완료되면 시작 메뉴에서 Ubuntu를 실행할 수 있습니다. 메시지가 표시되면 Ubuntu 사용자의 username과 password를 입력하세요.

그런 다음 다음 명령어들을 실행하세요:

# apt로 의존성 패키지 설치
$ sudo apt update
$ sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev

# Mise 버전 관리자 설치
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
$ source ~/.bashrc

# Mise로 Ruby를 전역으로 설치
$ mise use -g ruby@3

2 Ruby 설치 확인하기

Ruby가 설치되면 다음 명령어를 실행하여 정상 동작하는지 확인할 수 있습니다:

$ ruby --version
ruby 3.3.6

3 Rails 설치하기

Ruby에서 "gem"은 라이브러리나 Ruby 프로그램의 독립적인 패키지입니다. Ruby의 gem 명령어를 사용하여 RubyGems.org에서 Rails의 최신 버전과 그 의존성들을 설치할 수 있습니다.

Rails의 최신 버전을 설치하고 터미널에서 사용할 수 있도록 하려면 다음 명령어를 실행하세요:

$ gem install rails

Rails가 올바르게 설치되었는지 확인하기 위해, 다음을 실행하면 버전 번호가 출력되어야 합니다:

$ rails --version
Rails 8.0.0

만약 rails 명령어를 찾을 수 없다면, 터미널을 재시작해보세요.

이제 Rails 시작하기를 할 준비가 되었습니다!

맨 위로