docs/archive/START_NEO4J.md

🚀 START NEO4J - QUICK GUIDE

Status: ⚠️ Neo4j er IKKE kørende - skal startes først

---

✅ HVAD VI HAR

• ✅ Neo4j driver installeret (neo4j-driver@6.0.1)
• ✅ Neo4jGraphAdapter implementeret
• ✅ Integration kode klar
• ✅ Graceful degradation (systemet virker uden Neo4j)

---

❌ HVAD DER MANGLER

• ❌ Neo4j server kører ikke
• ❌ Ingen Docker container
• ❌ Ingen lokal installation

---

🚀 HVORDAN STARTER JEG NEO4J?

Option 1: Docker (Anbefalet) 🐳

Hvis du har Docker installeret:

# Start Neo4j
docker-compose up -d neo4j

# Vent 30 sekunder for startup
sleep 30

# Verificer at det virker
curl http://localhost:7474

# Eller åbn browser:
# http://localhost:7474
# Login: neo4j / password

Stop Neo4j:

docker-compose down neo4j

---

Option 2: Docker direkte (uden docker-compose)

docker run -d \
  --name neo4j-widgetdc \
  -p 7474:7474 -p 7687:7687 \
  -e NEO4J_AUTH=neo4j/password \
  -e NEO4J_PLUGINS='["apoc"]' \
  neo4j:5.15

# Vent 30 sekunder
sleep 30

# Test
curl http://localhost:7474

---

Option 3: Lokal installation

Ubuntu/Debian:

wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo apt-key add -
echo 'deb https://debian.neo4j.com stable latest' | sudo tee -a /etc/apt/sources.list.d/neo4j.list
sudo apt-get update
sudo apt-get install neo4j
sudo systemctl start neo4j

macOS:

brew install neo4j
brew services start neo4j

---

⚙️ ENVIRONMENT VARIABLES

Opret eller opdater apps/backend/.env:

# Neo4j Configuration
NEO4J_URI=bolt://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=password
NEO4J_DATABASE=neo4j

---

✅ VERIFICER NEO4J KØRER

1. Check HTTP port:

curl http://localhost:7474

2. Check Bolt port:

nc -zv localhost 7687

3. Åbn browser:

http://localhost:7474

4. Test fra backend:

cd apps/backend
npm run dev
# Se console output - skal se: "🕸️ Neo4j Graph Database initialized"

---

⚠️ HVIS NEO4J IKKE KAN STARTES

Systemet virker stadig!

• ✅ Bruger implicit graph patterns (CMA memory_relations)
• ✅ UnifiedGraphRAG virker uden Neo4j
• ✅ Alle features virker (bare uden explicit graph storage)

Du vil se denne besked:

⚠️  Neo4j not available (optional): [error]
   Continuing without Neo4j - using implicit graph patterns

---

🎯 NÆSTE STEPS EFTER NEO4J ER STARTET

1. ✅ Start Neo4j (se ovenfor)
2. ⏳ Opret MCP tools for Neo4j
3. ⏳ Opdater UnifiedGraphRAG til at bruge Neo4j
4. ⏳ Migrer CMA memory_relations til Neo4j

---

Status: ⚠️ Neo4j skal startes først
System: ✅ Virker uden Neo4j (graceful degradation)