Raspberry Pi und Webentwicklung: Ein praktischer Leitfaden (Teil 2)

27. Juni 2025

Von: Tomáš Bencko

Lesezeit: 6:30 min

SK

Raspberry pi

Im vorherigen Teil haben wir das Potenzial von Raspberry Pi-Geräten für die Webentwicklung beleuchtet und erklärt, worauf man bei der Auswahl des passenden Modells und Zubehörs achten sollte. Diesmal widmen wir uns den ersten Schritten nach dem Kauf – also wie man seinen Raspberry Pi sicher zusammenbaut, in Betrieb nimmt und für zukünftige Software-Experimente vorbereitet.

Aber erwarte kein Handbuch nach Schema F. Raspberry Pi bedeutet nicht einfach nur, Schritt-für-Schritt-Anleitungen abzuarbeiten – es geht darum, zu lernen, wie man denkt, improvisiert und unerwartete Probleme löst. Ein bisschen Frust gehört ganz normal dazu. Jeder Rückschlag oder jede Sackgasse ist auch eine Chance, etwas Neues zu lernen. In diesem Artikel geben wir dir einen Überblick über die wichtigsten Themenbereiche, die dir begegnen werden, und teilen ein paar Tipps, die dir helfen sollen, deinen Raspberry-Pi-Weg erfolgreich zu meistern.

Bevor du loslegst: Ein paar Grundsätze, die dir Kopfschmerzen ersparen

  • Teste Schritt für Schritt.
    Bevor du deinen Raspberry Pi in ein schickes Gehäuse einbaust und alle Schrauben festziehst, solltest du sicherstellen, dass alles wie erwartet funktioniert. Es ist immer besser, jedes Bauteil einzeln zu testen, als später durch ein komplett montiertes Setup nach Fehlern zu suchen.

  • Geduld ist der Schlüssel.
    Wenn du auf ein Problem stößt, lass dich nicht entmutigen. Versteh Verwirrung als Hinweis, einen Gang zurückzuschalten und dich tiefer mit der Technik auseinanderzusetzen. Jede Herausforderung, die du meisterst, macht dich sicherer und bringt dich weiter.

  • Zieh in Betracht, ein Display und eine Tastatur anzuschließen.
    Zwar kannst du deinen Raspberry Pi auch im sogenannten „Headless Mode“ einrichten – also ohne Monitor, Tastatur oder Maus. Aber besonders am Anfang kann es hilfreich sein, direkt visuelles Feedback und Eingabemöglichkeiten zu haben. Das macht das Troubleshooting wesentlich einfacher, wenn mal etwas nicht wie geplant läuft.

  • Nimm ChatGPTs Antworten mit einer Prise Salz.
    Der große Vorteil von Sprachmodellen ist, dass du sehr gezielt nach konkreten Situationen fragen kannst – oft führt das schnell zur Lösung. Aber: Unfehlbar sind sie nicht. Wenn dir etwas komisch oder unklar vorkommt, überprüfe es mit anderen Quellen. Oder bitte das KI-Modell zumindest, jeden Schritt genau zu erklären – damit du wirklich verstehst, was du tust, statt nur blind Anweisungen zu folgen.

Hardware-Montage

Wenn du deinen Raspberry Pi hauptsächlich als Webserver nutzen möchtest, ist der Aufbau in der Regel ziemlich unkompliziert. Halte dich einfach an die Anleitungen, die mit deinem Zubehör geliefert wurden – in den meisten Fällen reicht ein handelsüblicher PH1-Kreuzschlitzschraubendreher völlig aus.

Trotzdem gibt es ein paar wichtige Sicherheitsregeln, die du unbedingt beachten solltest:

  • Niemals microSD-Karte, SSD oder Netzteil entfernen, während das Gerät läuft.
    Das kann zu Datenverlust führen oder im schlimmsten Fall das Dateisystem dauerhaft beschädigen.

  • Achte auf den richtigen Griff.
    Wenn du den Raspberry Pi im eingeschalteten Zustand anfassen musst, halte ihn immer an den Außenkanten oder an den Ecken der Platine – zum Beispiel in der Nähe der Schraublöcher. Vermeide es, Chips oder andere elektronische Bauteile direkt zu berühren.

  • Vorsicht vor statischer Elektrizität.
    Ein Raspberry Pi ist ein empfindliches elektronisches Gerät, und die meisten Netzteile für den Pi sind nicht geerdet. Eine elektrostatische Entladung kann Bauteile beschädigen. Bevor du das Gerät berührst, entlade dich – zum Beispiel durch Berühren eines geerdeten Metallteils wie eines PC-Gehäuses oder eines Metallmöbels.

  • Kurzschlüsse vermeiden.
    Wenn du vorhast, die GPIO-Pins zu nutzen – etwa um Sensoren, LEDs oder andere Komponenten anzuschließen – überprüfe deine Verkabelung sorgfältig! Ein falscher Anschluss kann den Raspberry Pi sofort beschädigen.

  • Keine Gewalt anwenden.
    Sowohl die Platine als auch die einzelnen Komponenten sind empfindlich. Gehe behutsam mit allem um und vermeide unnötigen Druck. Gleichzeitig sollten alle Verbindungen fest sitzen – schlechte Verbindungen (häufig durch die kompakte Bauweise und enge Räume) sind ein häufiger Grund, warum etwas nicht funktioniert. Richtig eingesteckte Stecker geben oft ein leichtes „Klick“-Geräusch von sich – ein gutes Zeichen dafür, dass alles sicher sitzt.

So bekommst und konfigurierst du ein OS-Image

Bevor du deinen Raspberry Pi zum ersten Mal startest, brauchst du ein Betriebssystem. Falls du keine sehr speziellen Anforderungen durch bestimmte Tools hast, ist Raspberry Pi OS (früher bekannt als Raspbian, basierend auf Debian) in der Regel die einfachste und zuverlässigste Wahl – es läuft auf Raspberry-Geräten direkt out of the box.

So legst du los:

  • Lade den Raspberry Pi Imager herunter und installiere ihn auf deinem Computer (verfügbar für Windows, macOS und Linux).

  • Verbinde eine leere SD-Karte oder SSD mithilfe eines Adapters mit deinem Computer. Achtung: Alle Daten auf dem gewählten Laufwerk werden vollständig gelöscht. Sei besonders vorsichtig, wenn du beispielsweise einen offenen M.2-Slot nutzt – überprüfe genau, welches Laufwerk du beschreibst!

  • Öffne den Raspberry Pi Imager, wähle das gewünschte Betriebssystem aus und passe die Konfiguration an deine Bedürfnisse an – besonders wichtig, wenn du den Pi im Headless-Modus (also ohne Monitor und Tastatur) einrichtest.

  • In den erweiterten Einstellungen kannst du:
    • Den Hostnamen (also den Gerätenamen im Netzwerk) festlegen,
    • Einen eigenen Benutzernamen und ein Passwort erstellen,
    • WLAN-Zugangsdaten eintragen (damit sich das Gerät direkt beim ersten Start mit dem Netzwerk verbindet),
    • SSH-Zugriff aktivieren, um das Gerät aus der Ferne zu steuern.

Sicherheitstipp: Vermeide Standardzugänge wie pi@raspberrypi mit dem Passwort raspberry. Besser ist ein individueller Benutzername wie tomas_dev@rpiserver mit einem sicheren Passwort. Wenn du SSH verwenden willst, solltest du am besten gleich ein SSH-Schlüsselpaar mit Passphrase nutzen – das ist deutlich sicherer als ein einfaches Passwort.

  • Zum Schluss klickst du auf Write. Sobald der Vorgang abgeschlossen ist, kannst du die Karte (oder SSD) entnehmen, in deinen Raspberry Pi einsetzen – und los geht’s!
  • SSH (Secure Shell) ist ein sicheres Protokoll, mit dem du ein entferntes Gerät wie deinen Raspberry Pi über das Terminal steuern kannst – ganz bequem und geschützt von deinem eigenen Computer aus.

  • Zwar kannst du dich auch einfach per Benutzername und Passwort anmelden, doch die Authentifizierung mit einem SSH-Schlüssel ist deutlich sicherer – vor allem, wenn du planst, deinen Raspberry Pi über das Internet erreichbar zu machen. Außerdem sparst du dir das ständige Eingeben des Passworts bei jeder Verbindung.

  • Einen SSH-Schlüssel erstellst du im Terminal mit folgendem Befehl:
ssh-keygen -t ed25519 -C "dein_name@computer"
  • Der Parameter -C „dein_name@computer“ ist optional und dient lediglich als Kommentar, damit du deinen Schlüssel später leichter zuordnen kannst.

  • Wenn du mehrere SSH-Schlüssel verwendest, kannst du beim Schritt
    „Enter file in which to save the key“
    einen individuellen Dateinamen oder Pfad angeben – z. B. id_ed25519_rpiserver.

  • Das Festlegen einer Passphrase ist ebenfalls optional, bietet aber eine zusätzliche Sicherheitsebene – ohne Passphrase kann jeder, der an deinen privaten Schlüssel gelangt, ihn direkt missbrauchen.

  • Nach dem Erstellen werden zwei Dateien generiert:
    • ~/.ssh/id_ed25519 – dein privater Schlüssel. Dieser bleibt streng geheim und darf niemals weitergegeben werden.
    • ~/.ssh/id_ed25519.pub – dein öffentlicher Schlüssel, den du weitergeben kannst. Dein Raspberry Pi verwendet ihn, um dich als berechtigten Nutzer zu erkennen.
    •  
  • Um den öffentlichen Schlüssel anzuzeigen, verwende:
cat ~/.ssh/id_ed25519.pub
  • Wenn du einem Gerät später den Zugriff entziehen möchtest, entferne einfach den entsprechenden öffentlichen Schlüssel aus der Datei ~/.ssh/authorized_keys auf deinem Raspberry Pi.

Wie man ein Raspberry Pi-Gerät steuert

Wenn du planst, deinen Raspberry Pi als persönlichen Computer zu verwenden, sind lokale Peripheriegeräte (Monitor, Tastatur und Maus) selbstverständlich. Diese direkte Interaktion kann auch während der Ersteinrichtung oder bei der Fehlersuche bei komplexeren Problemen hilfreich sein. Auf diese Weise kannst du genau sehen, was auf dem Gerät passiert, und sofort reagieren. Wenn du deinen Raspberry Pi jedoch als Webserver betreiben möchtest, wirst du dich hauptsächlich für den Fernzugriff über SSH interessieren – der heute zum Standard geworden ist.

Wenn du deinen Raspberry Pi also von deinem Hauptcomputer aus steuern möchtest (und der SSH-Zugang auf dem Gerät bereits aktiviert ist), kannst du dies mit dem folgenden Befehl tun: ssh benutzername@hostname, wobei benutzername der Benutzername auf dem Raspberry Pi ist und hostname der Gerätename im lokalen Netzwerk. Wenn du die Passwortauthentifizierung gewählt hast, wirst du zur Eingabe aufgefordert. Wenn du die Authentifizierung per SSH-Schlüssel verwendest, hängt das Anmeldeverhalten davon ab, ob der Schlüssel mit einer Passphrase geschützt ist oder nicht. Wenn dein Schlüssel einen nicht standardmäßigen Namen hat oder an einem benutzerdefinierten Speicherort liegt, musst du den Pfad dazu ebenfalls angeben, zum Beispiel so:

ssh -i "C:\Users\<Benutzername>\.ssh\id_ed25519_rpiserver" tomas_dev@rpiserver

 

Wenn du beim Einloggen nicht jedes Mal den Pfad zum SSH-Schlüssel oder eine Passphrase eingeben möchtest, kannst du deinen Schlüssel beim Start in den SSH-Agenten deines Systems laden. Dieser merkt sich deine Schlüssel während der Sitzung – oder dauerhaft, wenn du es so einrichtest.

Hier ein Beispiel für Windows PowerShell (du musst die Konsole als Administrator ausführen):

				
					Set-Service -Name ssh-agent -StartupType Automatic # Sets the 'ssh-agent' service to start automatically with the system
Start-Service ssh-agent # Starts the 'ssh-agent' service immediately
Get-Service ssh-agent # Verifies that the agent is running (Status: Running)

# Add your key to the agent (may require passphrase if set):
ssh-add "C:\Users\<User Name>\.ssh\id_ed25519_rpiserver"

# Now you can connect like this, without re-entering the path or passphrase (the stored key will be used automatically):
ssh pi@rpiserver
				
			

Wenn du Probleme bei der Verbindung hast und prüfen möchtest, ob das Gerät überhaupt im Netzwerk erreichbar ist, versuche folgenden Befehl: ping <hostname>. Sobald die Verbindung erfolgreich hergestellt ist, kannst du das Gerät genauso steuern, als würdest du direkt am Terminal darauf arbeiten. Der erste Login ist der perfekte Zeitpunkt, um die Software auf deinem Gerät zu aktualisieren.

				
					sudo apt update # Downloads the latest list of available packages
sudo apt upgrade # Installs all available updates
sudo reboot # Restarts the device to apply changes fully
				
			

Grundlagen der Arbeit mit dem Linux-Terminal

Wenn du bisher noch keine praktische Erfahrung mit dem Linux-Terminal hast, ist jetzt der perfekte Zeitpunkt, um dich zumindest mit den Grundlagen vertraut zu machen. Das Terminal ermöglicht es dir, dein Gerät schnell und effizient über Texteingaben zu steuern. Hier ein kurzer Überblick über die wichtigsten Befehle zum Einstieg:

				
					ls # Lists the contents of the current directory (ls -a shows hidden files as well)
cd <directory> # Changes the current directory (e.g., cd /home/pi)
   # Use `..` to go up one level
   # Use `~` to return to the home directory
pwd # Prints the current path / working directory
mkdir <directory> # Creates a new directory
touch <file> # Creates a new file
rm <file> # Deletes a file (rm -r <directory> deletes a directory and its contents)
cp <source> <target> # Copies a file or directory
mv <source> <target> # Moves (or renames) a file / directory
nano <directory> # Simple text editor, great for quick config edits directly in the terminal (exit with Ctrl + X)
cat <file> # Displays the content of a file in the terminal
sudo <command> # Runs a command with administrative privileges (use with caution)
sudo apt update # Updates the list of available packages
sudo apt upgrade # Updates installed packages
sudo apt install <package_name> # Installs a package
exit # Ends the current SSH or terminal session
sudo reboot # Reboots the device
sudo shutdown -h now # Shuts down the device immediately
				
			

Das Linux-Terminal unterscheidet zwischen Groß- und Kleinschreibung – achte also bei der Eingabe von Befehlen oder Dateinamen auf die genaue Schreibweise. Du kannst deinen Arbeitsfluss beschleunigen, indem du mit den Pfeiltasten nach oben und unten durch deine vorherigen Befehle blätterst und mit der TAB-Taste Befehle oder Dateinamen automatisch vervollständigst.

Verwende das Symbol &&, um mehrere Befehle nacheinander auszuführen, und das Pipe-Symbol |, um die Ausgabe eines Befehls als Eingabe für einen anderen zu nutzen.

Wenn du dir bei einem Befehl unsicher bist, füge die Option –help hinzu (z. B. ls –help), oder verwende man <befehl> (z. B. man ls), um eine ausführliche Beschreibung aufzurufen.

Eine umfassende Liste von Befehlen findest du in der Linux Command Library, und wenn du einen praktischen Einstieg in Linux-Konzepte suchst, ist das Portal Linux Journey ein großartiger Ausgangspunkt.

Und jetzt — Lass uns loslegen!

Dein Raspberry Pi läuft endlich, das Terminal ist kein Feind mehr, SSH ist entmystifiziert und vielleicht weißt du inzwischen sogar, wie man die Platine richtig anfasst, ohne die Chips zu gefährden. Damit bist du bereit, deinen Raspberry Pi in eine echte Entwicklungsstation zu verwandeln: Installiere deine bevorzugten Programmiersprachen und Tools, richte Git ein und leg mit der lokalen Entwicklung los. Du kannst direkt auf dem Gerät coden – oder bequem mit deinem Editor auf dem Hauptrechner arbeiten, dank SSH-Zugriff, der in den meisten modernen Editoren bereits integriert ist oder sich per Plugin hinzufügen lässt.

Oder – wenn du bereit bist, das nächste Level zu erreichen – nutze deinen Raspberry Pi als sauberen Runtime-Server. In diesem Setup erledigst du Entwicklung und Build-Prozesse auf deiner leistungsstarken Workstation und überträgst anschließend nur den fertigen Code oder einen Docker-Container auf den Pi. Wie genau das funktioniert – und was du beachten solltest, bevor du eine App in den produktiven Einsatz bringst – das erfährst du im dritten und letzten Teil unserer Serie.

Unsere Reise beginnt gerade erst. Viel Erfolg!

Bild von Tomáš Bencko
Tomáš Bencko
Der Autor dieses Artikels ist Tomáš, ein Frontend-Entwickler mit Fokus auf React, Vue.js und TypeScript. Seine Aufgabe ist es, moderne und skalierbare Frontend-Lösungen zu schaffen – und das nicht nur auf technischer Ebene, sondern auch mit einem ausgeprägten Gespür für Design. Neben der Arbeit für Kunden sucht er ständig nach Möglichkeiten, die Teamarbeit effizienter zu gestalten, experimentiert mit KI und Automatisierung und bringt neue Ideen ein, die sowohl Projekte als auch seine Kolleg:innen voranbringen.

Weitere Artikel