Neo4j Railway

Production-ready Neo4j 5.15.0 Deployment optimiert für Railway’s Infrastruktur. Memory-optimierte Settings (768MB), APOC Plugin vorinstalliert, One-Click Deployment.

One-Click Deploy

Direkt von GitHub zu Railway deployen

Memory Optimiert

768MB total (256MB Pagecache + 512MB Heap)

APOC Plugin

Vorinstalliert für erweiterte Graph-Operationen

Health Checks

Automatisches Container-Monitoring

Quick Deploy

Deploy Button klicken

Gehe zu github.com/MacStenk/neo4j-railway und klicke “Deploy on Railway”
Passwort setzen

Setze NEO4J_AUTH in den Environment Variables:
```
NEO4J_AUTH=neo4j/dein-sicheres-passwort
```
Warten

Railway baut und deployed automatisch. Logs zeigen Started. wenn bereit.
Networking konfigurieren
- Settings → Networking → “Generate Domain” (HTTP)
- Settings → Networking → ”+ TCP Proxy” Port 7687 (Bolt)

Verbindung

URL: https://dein-projekt.railway.app
Username: neo4j
Password: dein-passwort

URL: bolt://maglev.proxy.rlwy.net:XXXXX
Username: neo4j
Password: dein-passwort

URL: bolt://neo4j.railway.internal:7687
Username: neo4j
Password: dein-passwort

Nur innerhalb des Railway-Projekts erreichbar.

Memory Konfiguration

Railway Plan	Pagecache	Heap Max	Heap Initial
Trial (512MB)	128M	384M	128M
Hobby (1GB)	256M	512M	256M
Pro (2GB+)	512M	1G	512M

Anpassen via Railway Variables:

railway variables set NEO4J_server_memory_pagecache_size=128M
railway variables set NEO4J_dbms_memory_heap_max__size=384M
railway redeploy

Data Persistence

Railway Dashboard → Settings → Volumes
”+ New Volume” klicken
Name: neo4j-data, Mount Path: /data, Size: 1GB+
Service redeploys automatisch

Kosten: ~$0.25/GB/Monat

Test Queries

// Test Node erstellen
CREATE (n:TestNode {name: 'Hello Railway', timestamp: timestamp()})
RETURN n;

// APOC testen
CALL apoc.help("apoc.create");

// Database Status
CALL dbms.components();

Troubleshooting

Container crasht sofort

Memory zu hoch konfiguriert. Reduziere:

railway variables set NEO4J_server_memory_pagecache_size=128M
railway variables set NEO4J_dbms_memory_heap_max__size=384M
railway redeploy

Bolt-Verbindung schlägt fehl

bolt:// verwenden, nicht bolt+s://
TCP Proxy in Railway Networking konfiguriert?
Testen: nc -zv maglev.proxy.rlwy.net PORT

Passwort vergessen

railway ssh
cypher-shell -u neo4j -p altes-passwort
CALL dbms.security.changePassword('neues-passwort');