Provider Guide

Node betreiben

Als Provider stellst du deine Hardware dem ThalamusNetwork-Netzwerk zur Verfügung und verdienst OTH-Token für jede beantwortete, bewertete Anfrage. Der Node-Prozess läuft im Hintergrund und übernimmt automatisch Jobs aus dem Netzwerk.

Voraussetzungen

Minimum

8 GB RAM
Docker Desktop installiert
Stabile Internetverbindung
Linux, macOS oder Windows

Welche Option passt zu mir?

Option A — Automatisch per ScriptEmpfohlen

Node Setup Konfigurator erzeugt ein install.sh / install.ps1. Das Script installiert Docker, zieht alle Images und startet alles automatisch.

Für: Einsteiger, schneller Start ohne manuelle Konfiguration

Option B — Ollama nativ + Node als DockerFür erfahrene Nutzer

Ollama läuft bereits auf dem PC. Nur der enigma-node Container wird gestartet und verbindet sich über host.docker.internal:11434.

Für: Ollama bereits installiert, Apple Silicon Mac mit macOS 14+

Option C — vLLM (höchste Performance)NVIDIA GPU

vLLM bietet maximalen Durchsatz auf NVIDIA-GPUs. Erfordert Python-Umgebung und separates Setup.

Für: Erfahrene Nutzer mit NVIDIA GPU und hohem Anfragevolumen

Option D — Desktop App (LM Studio / Jan.ai)Desktop

LM Studio oder Jan.ai laufen bereits. Node verbindet sich mit deren API-Server.

Für: Nutzer die bereits eine LLM Desktop-App verwenden

Option E — Manuell ohne ScriptVollständige Kontrolle

docker-compose.yml selbst schreiben und Container direkt starten. Kein Install-Script nötig.

Für: Fortgeschrittene, die volle Kontrolle über die Konfiguration wollen

Option A — Automatisch per Script

Option B — Ollama nativ

Ollama bereits installiert

1
Sicherstellen dass Ollama läuft
ollama list
Zeigt installierte Modelle. Falls leer: ollama pull phi3:mini
2
Im Node Setup: Backend "Ollama (nativ)" wählen
Port auf 11434 lassen (Standard). Node Setup Konfigurator → Backend: Ollama (nativ — bereits installiert) → Script herunterladen.
3
Script ausführen
Das Script startet nur den enigma-node Container. Er verbindet sich automatisch über host.docker.internal:11434 mit deiner lokalen Ollama-Installation.

Option E — Manuell ohne Script

Vollständige Kontrolle

Für wer die volle Kontrolle über die Konfiguration behalten möchte, ohne das Install-Script zu verwenden.

docker-compose.yml erstellen

Minimale Konfiguration für einen Node mit Ollama (ersetze Werte entsprechend):

services:
  ollama:
    image: ollama/ollama
    volumes:
      - ollama-data:/root/.ollama
    restart: unless-stopped

  enigma-node:
    image: ghcr.io/enigma-network/enigma-node:latest
    command:
      - "-server"
      - "https://server.enigmanet.org"   # Enigma Server URL
      - "-backend"
      - "ollama"
      - "-backend-addr"
      - "ollama:11434"
      - "-claim-token"
      - "DEIN_CLAIM_TOKEN"               # Aus dem Dashboard kopieren
    volumes:
      - node-data:/data
    depends_on:
      - ollama
    restart: unless-stopped

volumes:
  ollama-data:
  node-data:

2
Claim Token aus dem Dashboard holen
Dashboard → Node Setup → Script herunterladen → Claim Token ist im generierten Script enthalten. Alternativ: grep claim-token docker-compose.yml
3
Container starten und Modell laden
docker compose up -d
Modell laden (nach dem ersten Start):
docker compose exec ollama ollama pull phi3:mini

Node verwalten

Status prüfendocker compose ps

Logs anzeigendocker compose logs -f

Stoppendocker compose stop

Neu startendocker compose start

Update auf neue Versiondocker compose pull && docker compose up -d

Komplett entfernendocker compose down -v --rmi all

Häufige Probleme

Node erscheint mit models: [] im Dashboard

Modell lädt noch. Warte bis der Download abgeschlossen ist — Node aktualisiert sich alle 30 Sekunden.

"no such host" Fehler beim Start

Service-Name im docker-compose.yml stimmt nicht. Backend "Ollama (Docker)" im Node Setup Konfigurator neu generieren.

NVIDIA Runtime Fehler

Script mit CPU-Option neu herunterladen, oder NVIDIA Container Toolkit installieren: nvidia.github.io/libnvidia-container

Node verbindet sich nicht mit Server

Server URL im docker-compose.yml prüfen: muss die korrekte Enigma-Server-Adresse sein.

macOS: Timeout / sehr langsame Inferenz

Docker auf macOS nutzt keine GPU. Kleinere Modelle wählen (1B–3B) oder Ollama nativ mit macOS 14+ installieren.

Wenig Speicherplatz

Docker Volumes auf andere Festplatte: Docker Desktop → Settings → Resources → Disk image location

⚡ Node Setup Konfigurator — Script herunterladen Registrieren