{"id":6884,"date":"2026-05-09T07:17:31","date_gmt":"2026-05-09T07:17:31","guid":{"rendered":"https:\/\/help.peacedoorball.blog\/de\/?p=6884"},"modified":"2026-05-09T07:17:31","modified_gmt":"2026-05-09T07:17:31","slug":"so-installieren-sie-cockroachdb-unter-windows-11","status":"publish","type":"post","link":"https:\/\/help.peacedoorball.blog\/de\/so-installieren-sie-cockroachdb-unter-windows-11\/","title":{"rendered":"So installieren Sie CockroachDB unter Windows 11"},"content":{"rendered":"<p>Der Einstieg in <strong>verteilte SQL-Datenbanken<\/strong> unter Windows 11 kann anfangs etwas einsch\u00fcchternd wirken. Vielleicht m\u00f6chten Sie neue Ideen ausprobieren oder einfach nur lernen, wie die Profis Skalierung und Hochverf\u00fcgbarkeit umsetzen. Was auch immer Ihr Grund ist, die Installation <strong>von CockroachDB<\/strong> ist eine gute Wahl \u2013 die Datenbank ist modern, cloudf\u00e4hig und bei Entwicklern, die sich mit verteilten Systemen besch\u00e4ftigen, sehr beliebt. Ziel ist es, die Datenbank reibungslos zum Laufen zu bringen, damit Sie direkt auf Ihrem lokalen Rechner mit SQL in einer verteilten Umgebung experimentieren k\u00f6nnen. Es klingt kompliziert, aber mit den richtigen Schritten ist es auch f\u00fcr Einsteiger machbar.<\/p>\n<p>Diese Anleitung f\u00fchrt Sie durch alle Schritte \u2013 vom Herunterladen und den Systemvoraussetzungen bis hin zum Starten Ihres ersten Clusters. Bonus: Sie lernen die Funktionsweise des Web-Dashboards kennen, f\u00fchren SQL-Befehle aus und erstellen Ihre erste Datenbank. Manchmal kann es vorkommen, dass Windows Probleme mit Umgebungsvariablen oder Netzwerkports verursacht \u2013 daher habe ich einige dieser h\u00e4ufigen Schwierigkeiten ebenfalls ber\u00fccksichtigt. Am Ende verf\u00fcgen Sie \u00fcber einen lokalen CockroachDB-Cluster, der bereit ist, Ihre Lern- oder Testanforderungen zu erf\u00fcllen.<\/p>\n<h2>So installieren Sie CockroachDB unter Windows 11<\/h2>\n<h3>Dateien herunterladen und vorbereiten<\/h3>\n<p>Laden Sie zun\u00e4chst die neueste CockroachDB-Windows-ZIP-Datei von der <a href=\"https:\/\/www.cockroachlabs.com\/\" rel=\"noopener noreferrer\" target=\"_blank\">offiziellen Website<\/a> herunter. Normalerweise erkennt die Website Ihr Betriebssystem und zeigt Ihnen den passenden Download-Link an.\u00dcberpr\u00fcfen Sie aber zur Sicherheit, ob Sie die Windows-Version herunterladen. Speichern Sie die Datei nach dem Download im Ordner <strong>\u201eDownloads\u201c<\/strong> (oder auf dem Desktop, falls das einfacher ist).Sie m\u00fcssen den Installer nicht ausf\u00fchren \u2013 CockroachDB wird als ZIP-Archiv bereitgestellt, was praktisch ist, da es die Datei flexibel und ressourcenschonend h\u00e4lt.<\/p>\n<h3>Entpacken Sie die ZIP-Datei.<\/h3>\n<p>Klicken Sie mit der rechten Maustaste auf die ZIP-Datei, w\u00e4hlen Sie \u201e <strong>Alle extrahieren\u201c<\/strong> und anschlie\u00dfend einen einfachen Speicherort \u2013 ich verwende normalerweise <strong>C:\\CockroachDB<\/strong>. So ist die Datei sp\u00e4ter leichter wiederzufinden. Suchen Sie nach dem Extrahieren im Ordner nach der Datei \u201e <code>cockroach.exe<\/code>. Dies ist die zentrale ausf\u00fchrbare Datei f\u00fcr die Interaktion mit der Datenbank\u201c.Drag &amp; Drop im Windows Explorer funktioniert zwar auch, aber stellen Sie sicher, dass alle Dateien korrekt entpackt wurden, bevor Sie mit dem n\u00e4chsten Schritt fortfahren.<\/p>\n<h3>Verschieben Sie den Ordner an einen festen Speicherort<\/h3>\n<p>Es mag etwas ungew\u00f6hnlich klingen, aber es ist ratsam, den CockroachDB-Ordner an einem festen Ort au\u00dferhalb von Downloads oder Desktop zu speichern \u2013 beispielsweise unter <strong>C:\\CockroachDB<\/strong>. So vermeiden Sie versehentliches L\u00f6schen und unn\u00f6tige Ordnerstrukturen. Wenn Sie die \u00dcbersicht behalten m\u00f6chten, kopieren Sie den Ordner einfach nach C: oder in den Ordner \u201eProgramme\u201c (f\u00fchren Sie ihn dabei aber unbedingt als Administrator aus).Windows neigt dazu, Dateien im Download-Ordner manchmal zu vergessen, insbesondere nach Updates oder Aufr\u00e4umarbeiten.<\/p>\n<h3>F\u00fcgen Sie CockroachDB zum Windows-Pfad hinzu<\/h3>\n<p>Dies ist der wichtigste Schritt: Ihr System muss den Befehl \u201ecockroach\u201c in jedem Terminalfenster erkennen.\u00d6ffnen Sie das <strong>Startmen\u00fc<\/strong>, suchen Sie nach <strong>\u201eUmgebungsvariablen\u201c<\/strong> und w\u00e4hlen Sie <strong>\u201eSystemumgebungsvariablen bearbeiten\u201c<\/strong>. Klicken Sie anschlie\u00dfend auf <strong>\u201eUmgebungsvariablen\u201c<\/strong>. Suchen Sie unter <strong>\u201eSystemvariablen\u201c<\/strong> den Eintrag \u201e <strong>Path\u201c<\/strong> und klicken Sie auf <strong>\u201eBearbeiten\u201c<\/strong>.<\/p>\n<ul>\n<li>Klicken Sie auf <strong>Neu<\/strong><\/li>\n<li>Geben Sie den vollst\u00e4ndigen Pfad zu dem Verzeichnis ein, in dem Sie CockroachDB extrahiert haben, z. B.<code>C:\\CockroachDB\\cockroach-v25.1.0.windows-6.2-amd64<\/code><\/li>\n<\/ul>\n<p>Gehen Sie genauso vor, als w\u00fcrden Sie einen neuen Ordner zu Ihrem System hinzuf\u00fcgen und anschlie\u00dfend alle Dialogfelder mit \u201eOK\u201c best\u00e4tigen. So k\u00f6nnen Sie die Eingabeaufforderung oder das Windows Terminal \u00fcberall \u00f6ffnen und <code>cockroach<\/code>Befehle ausf\u00fchren, ohne sich mit Ordnerstrukturen herumschlagen zu m\u00fcssen. Manchmal ben\u00f6tigt Windows einen Neustart, um den neuen Pfad vollst\u00e4ndig zu erkennen. Vergessen Sie diesen Schritt also nicht, falls Befehle nicht sofort erkannt werden.<\/p>\n<h3>\u00dcberpr\u00fcfen Sie die Installation<\/h3>\n<p>\u00d6ffnen Sie <strong>das Windows-Terminal<\/strong> oder die Eingabeaufforderung und geben Sie Folgendes ein:<\/p>\n<pre><code>cockroach version<\/code><\/pre>\n<p>Dr\u00fccken Sie die Eingabetaste und warten Sie. Bei korrekter Einrichtung sollten Versionsinformationen angezeigt werden. Prima! Falls eine Meldung wie \u201eCockroach wird nicht erkannt\u201c erscheint, \u00fcberpr\u00fcfen Sie die PATH-Konfiguration erneut \u2013 m\u00f6glicherweise fehlt ein Ordner oder Sie m\u00fcssen Ihren Computer neu starten.<\/p>\n<h3>Starten Sie einen lokalen CockroachDB-Knoten<\/h3>\n<p>Jetzt ist es an der Zeit, den Schl\u00fcssel umzudrehen und das Ding zu starten. F\u00fchren Sie im Terminal folgenden Befehl aus:<\/p>\n<pre><code>cockroach start-single-node --insecure<\/code><\/pre>\n<p>Dadurch wird ein Einzelknoten-Cluster initialisiert (ideal f\u00fcr lokale Tests).M\u00f6glicherweise sehen Sie einige Protokollmeldungen \u2013 das ist normal. Sobald der Server stabil l\u00e4uft und eine URL wie <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080<\/a> angezeigt wird, ist er betriebsbereit und die Weboberfl\u00e4che erreichbar. Lassen Sie dieses Fenster ge\u00f6ffnet, da der Server darauf angewiesen ist.<\/p>\n<h3>Stellen Sie eine Verbindung zur SQL-Shell her.<\/h3>\n<p>\u00d6ffnen Sie ein weiteres Terminalfenster und f\u00fchren Sie folgenden Befehl aus:<\/p>\n<pre><code>cockroach sql --insecure<\/code><\/pre>\n<p>Sie befinden sich nun in der interaktiven Shell. Die Eingabeaufforderung sollte wie folgt aussehen <code>root@localhost:26257\/defaultdb&gt;<\/code>:.Probieren Sie einige Befehle aus \u2014<\/p>\n<ul>\n<li><code>SHOW DATABASES;<\/code><\/li>\n<li><code>CREATE DATABASE mytest;<\/code><\/li>\n<li><code>USE mytest;<\/code><\/li>\n<li><code>CREATE TABLE users (id INT PRIMARY KEY, name STRING);<\/code><\/li>\n<li><code>INSERT INTO users VALUES (1, 'Liam');<\/code><\/li>\n<li><code>SELECT * FROM users;<\/code><\/li>\n<\/ul>\n<p>Wenn alles einwandfrei angezeigt wird, herzlichen Gl\u00fcckwunsch \u2013 die Datenbank steht Ihnen nun offen.<\/p>\n<h3>Zugriff auf das Web-Dashboard<\/h3>\n<p>\u00d6ffnen Sie Ihren Browser und rufen Sie <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080<\/a> auf. Dort finden Sie detaillierte Statistiken, Knoteninformationen und die Abfrageleistung \u2013 hilfreich, wenn Sie das Verhalten von CockroachDB verstehen oder Ihren kleinen Cluster \u00fcberwachen m\u00f6chten. Obwohl es sich um eine lokale Anwendung handelt, bietet dieses Dashboard einen Einblick in die Funktionsweise eines realen verteilten Systems.<\/p>\n<h3>Server stoppen<\/h3>\n<p>Schlie\u00dfen Sie nach Abschluss der Arbeit nicht einfach alle Fenster. Gehen Sie zur\u00fcck zu Ihrem Serverterminal und dr\u00fccken Sie die entsprechende Taste <kbd>Ctrl + C<\/kbd>. CockroachDB wird ordnungsgem\u00e4\u00df beendet. Warten Sie, bis der Vorgang abgeschlossen ist, und schlie\u00dfen Sie dann Ihre Fenster. Dies verhindert Datenbesch\u00e4digung und das Verbleiben von Prozessen.<\/p>\n<h2>Was schiefgehen kann (und wie man es behebt)<\/h2>\n<h3>Kakerlaken-Befehl nicht gefunden<\/h3>\n<p>Wenn Ihr Terminal die Fehlermeldung \u201ecockroach\u201c anzeigt, liegt das fast immer an einem Problem mit der PATH-Umgebungsvariablen.\u00dcberpr\u00fcfen Sie, ob der zuvor hinzugef\u00fcgte Ordnerpfad korrekt ist. Manchmal behebt ein Neustart das Problem, manchmal m\u00fcssen Sie die Umgebungsvariablen neu konfigurieren.<\/p>\n<h3>Blockiert Windows Defender es?<\/h3>\n<p>Das kann vorkommen, insbesondere beim ersten Start. Falls Windows Sicherheitswarnungen anzeigt, erteilen Sie einfach die Berechtigung f\u00fcr die Datei cockroach.exe oder f\u00fcgen Sie eine Ausnahme hinzu. Es ist zwar l\u00e4stig, aber Windows ist hier \u00fcbervorsichtig.<\/p>\n<h3>Hafenkonflikte<\/h3>\n<p>CockroachDB verwendet standardm\u00e4\u00dfig Port 26257 und 8080 f\u00fcr das Dashboard. Falls diese Ports bereits von einer anderen Anwendung belegt sind, startet der Server nicht.\u00dcberpr\u00fcfen Sie dies mit <a href=\"https:\/\/netstat.io\/\" rel=\"noopener noreferrer\" target=\"_blank\">netstat<\/a><code>--listen-addr<\/code> oder Ihrem Task-Manager und beenden Sie entweder die betreffende Anwendung oder geben Sie mithilfe von Parametern wie `&#8211;port` oder `&#8211;port` andere Ports an <code>--http-addr<\/code>.<\/p>\n<h2>H\u00e4ufig gestellte Fragen<\/h2>\n<h3>Ist CockroachDB kostenlos f\u00fcr Windows 11?<\/h3>\n<p>Ja. Die Community-Version ist kostenlos und eignet sich perfekt zum Testen, Lernen oder f\u00fcr kleinere Projekte.<\/p>\n<h3>Kann ich CockroachDB offline betreiben?<\/h3>\n<p>Absolut. Nach dem Herunterladen und Installieren ist keine Internetverbindung mehr n\u00f6tig \u2013 alles l\u00e4uft lokal.<\/p>\n<h3>Ist es anf\u00e4ngerfreundlich?<\/h3>\n<p>Absolut. Verteilte Datenbanken klingen zwar komplex, aber dank der CLI und der Web-Oberfl\u00e4che von CockroachDB ist der Einstieg \u00fcberraschend einfach. Man sollte sich lediglich auf einige neue Konzepte zu Skalierung und Fehlertoleranz einstellen.<\/p>\n<h3>\u00c4hnlich wie PostgreSQL?<\/h3>\n<p>Ja, es unterst\u00fctzt PostgreSQL-kompatible SQL-Syntax. Wenn Sie also PostgreSQL gewohnt sind, sollte der \u00dcbergang reibungsloser verlaufen.<\/p>\n<h3>Docker erforderlich?<\/h3>\n<p>Nein, \u00fcberhaupt nicht. Sie k\u00f6nnen es direkt ohne Docker installieren \u2013 folgen Sie einfach den oben genannten Schritten.<\/p>\n<h3>Ist es mit Programmiersprachen kompatibel?<\/h3>\n<p>Absolut. Es bietet Treiber und Clients f\u00fcr Sprachen wie Python, Java, Node.js, Go, PHP \u2013 was auch immer Sie ausprobieren m\u00f6chten.<\/p>\n<p>Hoffentlich hilft das jemandem bei der Ersteinrichtung, ohne dass man sich die Haare raufen muss. Im Idealfall l\u00e4uft alles wie am Schn\u00fcrchen. Ich dr\u00fccke die Daumen!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Der Einstieg in verteilte SQL-Datenbanken unter Windows 11 kann anfangs etwas einsch\u00fcchternd wirken. Vielleicht m\u00f6chten Sie neue Ideen ausprobieren oder einfach nur lernen, wie die<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-6884","post","type-post","status-publish","format-standard","hentry","category-hilfe"],"_links":{"self":[{"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/posts\/6884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/comments?post=6884"}],"version-history":[{"count":0,"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/posts\/6884\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/media?parent=6884"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/categories?post=6884"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/de\/wp-json\/wp\/v2\/tags?post=6884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}