Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neo4j
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Neo4j ist eine Graphdatenbank: Sie speichert Dinge als Knoten und die Beziehungen zwischen ihnen als eigene Verbindungen mit Richtung und Eigenschaften. Das passt gut zu Daten, bei denen vor allem die Zusammenhänge zählen, etwa Verkehrsnetze, Stammbäume, Abhängigkeiten zwischen Programmteilen oder Wissensnetze. Abgefragt wird Neo4j mit der Sprache Cypher, in der man Muster aus Knoten und Pfeilen fast wie eine Skizze hinschreibt. Diese Anleitung installiert die freie Community Edition, sichert sie ab und baut ein kleines Bahnnetz als Beispiel.
Vorbemerkungen
- Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für Neo4j. Neo4j betreibt aber ein eigenes apt-Archiv. Nach dem Einbinden installiert und aktualisiert
aptNeo4j wie jedes andere Paket. - Community Edition: Das Paket
neo4jist die freie Ausgabe unter der Lizenz GPLv3. Das Paketneo4j-enterpriseaus demselben Archiv ist kostenpflichtig und wird hier nicht gebraucht. - Java: Neo4j ist in Java geschrieben und läuft nur mit Java 21 oder 25. Das Paket zieht Java 21 automatisch mit. Ist auf dem Rechner eine neuere Java-Version als Standard eingestellt (z. B. Java 26 aus der Anleitung Java), würde Neo4j mit dieser starten. Schritt 13 legt deshalb fest, dass der Dienst immer Java 21 nimmt.
- Nur lokal erreichbar: Neo4j lauscht nach der Installation nur auf
127.0.0.1. Port 7687 ist für Programme und die Kommandozeile (Protokoll Bolt), Port 7474 für die Weboberfläche Neo4j Browser. - Datenübertragung abschalten: Neo4j schickt in der Grundeinstellung anonyme Nutzungsdaten an den Hersteller und meldet sich per Rundruf im lokalen Netz. Schritt 11 schaltet beides vor dem ersten Start ab.
- Version: Getestet mit Neo4j 2026.09.0 am 2. Oktober 2026.
Paketquelle einbinden
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.
sudo apt update
2. Hilfsprogramme installieren
wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.
sudo apt install wget ca-certificates
3. Signaturschlüssel herunterladen
Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von Neo4j stammen und unterwegs nicht verändert wurden. Der Ordner /etc/apt/keyrings ist unter Ubuntu für selbst hinzugefügte Schlüssel gedacht. Der Schlüssel liegt als Text vor, mit der Endung .asc kann apt ihn direkt lesen.
sudo wget -O /etc/apt/keyrings/neo4j.asc https://debian.neo4j.com/neotechnology.gpg.key
Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.
head -n 1 /etc/apt/keyrings/neo4j.asc
4. Paketquelle eintragen
Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.
sudo nano /etc/apt/sources.list.d/neo4j.sources
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
Types: deb
URIs: https://debian.neo4j.com
Suites: stable
Components: latest
Architectures: amd64
Signed-By: /etc/apt/keyrings/neo4j.asc
Suites: stable– Das Archiv von Neo4j ist nicht nach Ubuntu-Versionen aufgeteilt, alle Systeme nutzen denselben Bereich.Components: latest– Immer die neueste Neo4j-Version. Wer bei der älteren Reihe 5 bleiben muss, schreibt hier5.Signed-By– Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 angenommen.
5. Paketlisten neu einlesen
Erst jetzt lädt apt das Paketverzeichnis von Neo4j herunter.
sudo apt update
Prüfen: In der Ausgabe erscheint eine Zeile mit https://debian.neo4j.com stable InRelease, und der Installationskandidat ist eine Version wie 1:2026.09.0.
apt policy neo4j
Installation
6. Neo4j installieren
Installiert den Server, die Kommandozeile cypher-shell und Java 21. Das Paket meldet den Dienst für den Systemstart an, startet ihn aber noch nicht. So bleibt Zeit, ihn vorher einzurichten.
sudo apt install neo4j
7. Version prüfen
neo4j --version
Prüfen: Es erscheint die Versionsnummer, z. B. 2026.09.0. Steht darüber eine Warnung zu einer nicht unterstützten Java-Version, ist das an dieser Stelle harmlos. Für den Dienst wird das in Schritt 13 gelöst.
Vor dem ersten Start einrichten
8. Konfigurationsdatei öffnen
Die Einstellungen von Neo4j stehen in /etc/neo4j/neo4j.conf.
sudo nano /etc/neo4j/neo4j.conf
9. An das Ende der Datei springen
Drücke Strg+Ende. Der Cursor steht dann unter dem letzten Abschnitt „Other Neo4j system properties“.
10. Leerzeile einfügen
Drücke Enter, damit die neuen Zeilen vom bisherigen Text abgesetzt sind.
11. Datenübertragung abschalten
Füge diese drei Zeilen ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
dbms.usage_report.enabled=false
dbms.fleet_manager.enabled=false
server.fleet_discovery.enabled=false
dbms.usage_report.enabled=false– Neo4j schickt keine anonymen Nutzungsdaten mehr an den Hersteller.dbms.fleet_manager.enabled=false– Schaltet die Anbindung an die Überwachung im Cloud-Dienst von Neo4j ab.server.fleet_discovery.enabled=false– Neo4j sendet keine Rundrufe mehr ins lokale Netz, mit denen sich Server gegenseitig finden.
12. Ordner für die Dienst-Ergänzung anlegen
Die Einstellung für Java gehört in eine Ergänzungsdatei (Drop-in) zum Dienst. So bleibt die Dienstdatei aus dem Paket unverändert und wird bei einem Update nicht überschrieben.
sudo mkdir -p /etc/systemd/system/neo4j.service.d
13. Java 21 für den Dienst festlegen
sudo nano /etc/systemd/system/neo4j.service.d/override.conf
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
[Service]
Environment=JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
JAVA_HOME zeigt auf das Java 21 aus Schritt 6. Das Startskript von Neo4j nimmt dann dieses Java, egal welche Version der Befehl java gerade startet.
14. systemd die Änderung mitteilen
systemd liest Dienstdateien nur beim Start oder auf Anweisung neu ein.
sudo systemctl daemon-reload
15. Dienst starten
sudo systemctl start neo4j
16. Prüfen, ob der Dienst läuft
Der Start dauert einige Sekunden.
systemctl status neo4j
Prüfen: In der Ausgabe steht active (running), und weiter unten erscheinen nach kurzer Zeit die Zeilen Bolt enabled on localhost:7687 und Started.. Beende die Anzeige mit q.
17. Prüfen, dass Neo4j nur lokal lauscht
sudo ss -ltnp | grep java
Prüfen: Es erscheinen zwei Zeilen mit 127.0.0.1:7474 und 127.0.0.1:7687 (davor kann [::ffff: stehen). Steht dort 0.0.0.0 oder *, wäre Neo4j aus dem Netz erreichbar.
18. Prüfen, welches Java läuft
sudo journalctl -u neo4j | grep -i "unsupported"
Prüfen: Der Befehl gibt nichts aus. Erscheint eine Warnung zu einer nicht unterstützten Java-Version, stimmt der Pfad in Schritt 13 nicht oder Schritt 14 wurde ausgelassen.
Erste Anmeldung
19. Kommandozeile öffnen
Neo4j legt den Benutzer neo4j mit dem Passwort neo4j an. Dieses Passwort gilt nur für die erste Anmeldung und muss sofort geändert werden.
cypher-shell -u neo4j
Bei password: gibst du neo4j ein. Die Eingabe ist nicht zu sehen.
20. Neues Passwort festlegen
Es erscheint Password change required. Gib bei new password: ein eigenes Passwort mit mindestens 8 Zeichen ein und wiederhole es bei confirm password:.
Prüfen: Es erscheint Connected to Neo4j … as user neo4j. und darunter eine Eingabezeile.
Steht ganz oben You are using an unsupported version of the Java runtime, ist eine neuere Java-Version als Standard eingestellt. cypher-shell funktioniert trotzdem, die Meldung kann man übergehen.
21. Kommandozeile verlassen
:exit
Ein kleines Bahnnetz anlegen
Das Beispiel legt einige Bahnhöfe zwischen Hamburg und Lübeck als Knoten an. Die Fahrten zwischen ihnen werden Beziehungen mit der Fahrzeit in Minuten.
Ein paar Begriffe aus Cypher:
(a:Ort {name: 'Ahrensburg'})– ein Knoten mit dem Etikett (Label)Ortund der Eigenschaftname. Der Buchstabeaist ein Platzhalter, über den man den Knoten in derselben Anweisung wieder ansprechen kann.-[:FAEHRT_NACH {minuten: 6}]->– eine Beziehung vom TypFAEHRT_NACHmit Richtung und einer Eigenschaft.CREATElegt an,MATCHsucht nach einem Muster,RETURNgibt das Ergebnis aus.
22. Übungsordner anlegen
mkdir -p ~/neo4j-uebung
23. In den Ordner wechseln
cd ~/neo4j-uebung
24. Datei mit dem Beispielnetz anlegen
nano bahn.cypher
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
CREATE CONSTRAINT ort_name IF NOT EXISTS
FOR (o:Ort) REQUIRE o.name IS UNIQUE;
CREATE (ahr:Ort {name: 'Ahrensburg'}),
(barg:Ort {name: 'Bargteheide'}),
(bad:Ort {name: 'Bad Oldesloe'}),
(hh:Ort {name: 'Hamburg Hbf'}),
(wand:Ort {name: 'Hamburg-Wandsbek'}),
(hl:Ort {name: 'Lübeck Hbf'}),
(hh)-[:FAEHRT_NACH {minuten: 9}]->(wand),
(wand)-[:FAEHRT_NACH {minuten: 10}]->(ahr),
(ahr)-[:FAEHRT_NACH {minuten: 6}]->(barg),
(barg)-[:FAEHRT_NACH {minuten: 8}]->(bad),
(bad)-[:FAEHRT_NACH {minuten: 15}]->(hl),
(hh)-[:FAEHRT_NACH {minuten: 40}]->(hl);
- Der erste Befehl sorgt dafür, dass jeder Ortsname nur einmal vorkommen darf. Gleichzeitig legt Neo4j dafür einen Index an, über den Orte schnell gefunden werden.
- Der zweite Befehl legt sechs Orte und sechs Verbindungen in einem Rutsch an. Die Fahrzeiten sind ausgedachte Beispielwerte.
25. Datei ausführen
-f liest die Befehle aus der Datei. Danach fragt cypher-shell nach dem Passwort aus Schritt 20.
cypher-shell -u neo4j -f bahn.cypher
Prüfen: Es erscheint keine Fehlermeldung. Bei einem zweiten Aufruf meldet Neo4j dagegen einen Fehler mit property uniqueness constraint violated, weil es Ahrensburg schon gibt. Die Regel aus dem ersten Befehl wirkt also.
Abfragen
26. Kommandozeile öffnen
cypher-shell -u neo4j
Jede Anweisung endet mit einem Semikolon. Erst dann führt cypher-shell sie aus.
27. Alle Orte anzeigen
MATCH (o:Ort) RETURN o.name ORDER BY o.name;
Prüfen: Es erscheinen sechs Orte in alphabetischer Reihenfolge.
28. Alle Verbindungen anzeigen
Das Muster beschreibt zwei Orte, zwischen denen ein Pfeil vom Typ FAEHRT_NACH liegt.
MATCH (a:Ort)-[f:FAEHRT_NACH]->(b:Ort)
RETURN a.name AS von, b.name AS nach, f.minuten AS minuten;
Prüfen: Die Tabelle hat sechs Zeilen, darunter "Ahrensburg" | "Bargteheide" | 6.
29. Erreichbare Orte finden
*1..3 bedeutet: ein bis drei Verbindungen hintereinander. So findet die Abfrage alle Orte, die von Ahrensburg aus mit höchstens drei Fahrten erreichbar sind.
MATCH (:Ort {name: 'Ahrensburg'})-[:FAEHRT_NACH*1..3]->(ziel)
RETURN DISTINCT ziel.name AS erreichbar;
Prüfen: Es erscheinen Bargteheide, Bad Oldesloe und Lübeck Hbf. Hamburg fehlt, weil die Pfeile nur in eine Richtung zeigen.
30. Alle Wege mit Fahrzeit vergleichen
->+ steht für eine oder beliebig viele Verbindungen. reduce addiert die Minuten aller Abschnitte eines Weges.
MATCH p = (:Ort {name: 'Hamburg Hbf'})-[:FAEHRT_NACH]->+(:Ort {name: 'Lübeck Hbf'})
RETURN [o IN nodes(p) | o.name] AS weg,
reduce(summe = 0, f IN relationships(p) | summe + f.minuten) AS minuten
ORDER BY minuten;
Prüfen: Es erscheinen zwei Wege: die direkte Verbindung mit 40 Minuten und der Weg über Wandsbek, Ahrensburg, Bargteheide und Bad Oldesloe mit 48 Minuten.
31. Einem Ort eine Eigenschaft hinzufügen
SET ändert oder ergänzt Eigenschaften. Neue Eigenschaften müssen vorher nirgends angemeldet werden.
MATCH (o:Ort {name: 'Bad Oldesloe'}) SET o.kreisstadt = true RETURN o;
Prüfen: Die Ausgabe zeigt (:Ort {kreisstadt: TRUE, name: "Bad Oldesloe"}).
32. Einen Ort samt Verbindungen löschen
Ein Knoten mit Beziehungen lässt sich nur zusammen mit diesen löschen. Das erledigt DETACH DELETE.
MATCH (o:Ort {name: 'Hamburg-Wandsbek'}) DETACH DELETE o;
33. Knoten zählen
MATCH (n) RETURN count(n) AS knoten;
Prüfen: Das Ergebnis ist 5.
34. Kommandozeile verlassen
:exit
Weboberfläche Neo4j Browser
35. Browser öffnen
Neo4j bringt eine Weboberfläche mit, die Ergebnisse auch als Grafik mit Kreisen und Pfeilen zeigt. Öffne im Browser diese Adresse:
http://localhost:7474/browser/
Es erscheint das Fenster „Connect to instance“. Die Adresse neo4j://localhost:7687 und der Benutzer neo4j sind schon eingetragen. Gib bei „Password“ das Passwort aus Schritt 20 ein und klicke auf Connect.
Prüfen: Gib oben in die Eingabezeile MATCH (o:Ort)-[f]->(z) RETURN o, f, z ein und starte die Abfrage mit Enter oder dem Startknopf daneben. Das Bahnnetz erscheint als Grafik.
Sichern und wiederherstellen
Die Community Edition kann eine Datenbank nur sichern, während der Dienst angehalten ist. Die Sicherung ist eine einzelne Datei.
36. Dienst anhalten
sudo systemctl stop neo4j
37. Ordner für Sicherungen anlegen
Die Sicherung schreibt der Benutzer neo4j, deshalb gehört ihm auch der Ordner.
sudo install -d -o neo4j -g neo4j /var/backups/neo4j
38. Sicherung anlegen
neo4j-admin ist das Verwaltungsprogramm. database dump neo4j sichert die Datenbank mit dem Namen neo4j, in der die Beispieldaten liegen. sudo -u neo4j führt den Befehl als Benutzer neo4j aus, damit die Dateirechte stimmen. JAVA_HOME sorgt wie in Schritt 13 für Java 21.
sudo -u neo4j JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 neo4j-admin database dump neo4j --to-path=/var/backups/neo4j
Prüfen: Die letzte Zeile lautet Dump completed successfully, und im Ordner liegt die Datei neo4j.dump.
ls -l /var/backups/neo4j
39. Dienst wieder starten
sudo systemctl start neo4j
Zum Wiederherstellen hältst du den Dienst an und spielst die Datei mit load zurück. --overwrite-destination=true ersetzt dabei den aktuellen Inhalt der Datenbank vollständig:
sudo -u neo4j JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 neo4j-admin database load neo4j --from-path=/var/backups/neo4j --overwrite-destination=true
Danach den Dienst wieder starten.
Optional: Autostart ausschalten
Neo4j belegt mit Java schnell ein bis zwei Gigabyte Arbeitsspeicher. Wer es nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start neo4j.
sudo systemctl disable --now neo4j
Wie geht es weiter?
- Arbeitsspeicher begrenzen: In
/etc/neo4j/neo4j.conflassen sich mitserver.memory.heap.max_sizeundserver.memory.pagecache.sizefeste Grenzen setzen. Ohne diese Angaben richtet sich Neo4j nach dem vorhandenen Arbeitsspeicher. - Aus Programmen zugreifen: Neo4j bietet offizielle Treiber für Python, Java, JavaScript, Go und .NET. In Python installiert man den Treiber in einer virtuellen Umgebung mit
pip install neo4j. - Schlüssel läuft ab: Der Signaturschlüssel von Neo4j ist bis Ende 2026 gültig. Meldet
sudo apt updatespäter einen abgelaufenen Schlüssel (EXPKEYSIG), lädst du ihn mit Schritt 3 neu herunter. - Andere Art von Graph: Für Wissensnetze nach dem Standard RDF mit der Abfragesprache SPARQL gibt es Apache Jena Fuseki.
- Dokumentation: Das Handbuch zu Cypher steht unter https://neo4j.com/docs/cypher-manual/current/.
Deinstallieren
1. Übungsordner und Befehlsverlauf löschen
~/.neo4j enthält den Verlauf der Befehle, die du in cypher-shell eingegeben hast.
rm -rf ~/neo4j-uebung ~/.neo4j
2. Dienst anhalten
sudo systemctl stop neo4j
3. Neo4j entfernen
Achtung: purge löscht ohne Nachfrage alle Datenbanken in /var/lib/neo4j und die Protokolle in /var/log/neo4j. Sicherungen in /var/backups/neo4j bleiben erhalten.
sudo apt purge neo4j cypher-shell
4. Übrige Abhängigkeiten entfernen
Entfernt Java 21 und die übrigen Pakete, die nur für Neo4j installiert wurden. apt listet sie auf und fragt vor dem Löschen nach. Ist ein Paket dabei, das du noch brauchst, brich mit n ab.
sudo apt autoremove --purge
5. Dienst-Ergänzung löschen
sudo rm -r /etc/systemd/system/neo4j.service.d
6. systemd die Änderung mitteilen
sudo systemctl daemon-reload
7. Paketquelle und Schlüssel löschen
sudo rm /etc/apt/sources.list.d/neo4j.sources /etc/apt/keyrings/neo4j.asc
8. Paketlisten aktualisieren
Danach kennt apt die Pakete von Neo4j nicht mehr.
sudo apt update
9. Sicherungen löschen (optional)
Achtung: Danach lassen sich die Daten nicht mehr wiederherstellen.
sudo rm -r /var/backups/neo4j
Prüfen: Der Befehl neo4j wird nicht mehr gefunden.
neo4j --version
Quellen und Lizenz
- Offizielle Dokumentation: https://neo4j.com/docs/
- Lizenz: Neo4j steht unter der GPL-3.0 (Community Edition).
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.