Vollständige Anleitung: Ruby on Rails auf Ubuntu LTS installieren

Melden

Hier ist ein umfassendes Tutorial, wie du Ruby on Rails „richtig“ auf Ubuntu LTS-Distributionen installierst. „Richtig“ bedeutet in diesem Kontext die Verwendung eines Version-Managers (rbenv), anstatt die System-Pakete zu nutzen. Dies verhindert Berechtigungsprobleme und ermöglicht den Wechsel zwischen verschiedenen Ruby-Versionen.

Diese Anleitung ist für alle gängigen Ubuntu LTS-Versionen geeignet. Wir verwenden rbenv, um Ruby zu installieren, da dies die sauberste und stabilste Methode für Entwickler ist.


Schritt 1: Das System aktualisieren und Abhängigkeiten installieren

Zuerst bringen wir das System auf den neuesten Stand und installieren die notwendigen Bibliotheken, die für das Kompilieren von Ruby benötigt werden.

Öffne dein Terminal und gib folgende Befehle ein:

sudo apt update
sudo apt upgrade

sudo apt install git-core zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

Schritt 2: rbenv und ruby-build installieren

Anstatt Ruby direkt zu installieren, installieren wir rbenv. Dies hilft uns, die Ruby-Umgebung lokal in deinem Benutzerverzeichnis zu verwalten.

  1. Klonen des rbenv-Repositorys:

    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
    echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
    echo 'eval "$(rbenv init -)"' >> ~/.bashrc
    exec $SHELL
  2. Installieren des ruby-build Plugins (wird benötigt, um Ruby-Versionen einfach zu installieren):

    git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
    echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
    exec $SHELL

Schritt 3: Ruby installieren

Jetzt installieren wir die gewünschte Ruby-Version. (Empfohlen ist aktuell die Version 3.2 oder höher).

  1. Installiere Ruby (dies kann einige Minuten dauern, da es kompiliert wird):

    rbenv install 3.2.2
  2. Setze die installierte Version als Standard:

    rbenv global 3.2.2
  3. Überprüfe die Installation:

    ruby -v

Schritt 4: Bundler installieren

Bundler ist das Werkzeug, das die Abhängigkeiten (Gems) deiner Rails-Projekte verwaltet.

gem install bundler

Schritt 5: Node.js und Yarn installieren

Rails benötigt eine JavaScript-Laufzeitumgebung für den Asset-Pipeline-Prozess (Kompilieren von CSS und JS).

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

Schritt 6: Rails installieren

Nun installieren wir das eigentliche Rails-Framework. Wir verwenden den Befehl gem install.

gem install rails

Damit das System den rails-Befehl erkennt, führen wir einen Rehash von rbenv aus:

rbenv rehash

Überprüfe nun, ob Rails korrekt installiert wurde:

rails -v

Schritt 7: Ein Testprojekt erstellen (Optional)

Um sicherzustellen, dass alles funktioniert, erstellen wir eine kleine Test-Anwendung:

  1. Erstelle das Projekt:
    rails new mein_test_projekt
  2. Wechsel in das Verzeichnis:
    cd mein_test_projekt
  3. Starte den Server:
    rails server

Öffne nun deinen Browser und besuche http://localhost:3000. Wenn du die Seite „Yay! You’re on Rails!“ siehst, ist deine Installation perfekt abgeschlossen.


Tipps für den Erfolg:

  • Kein sudo für Gems: Benutze niemals sudo gem install ..., wenn du rbenv verwendest. Das würde die Berechtigungen in deinem Home-Verzeichnis beschädigen.
  • Datenbanken: Für professionelle Projekte wirst du wahrscheinlich PostgreSQL statt des standardmäßigen SQLite verwenden wollen. Dieses kannst du einfach über sudo apt install postgresql libpq-dev nachinstallieren.
  • Updates: Um rbenv und ruby-build später zu aktualisieren, gehe einfach in die jeweiligen Ordner (cd ~/.rbenv) und mache einen git pull.
0