Selbst-Hosting: Schritt-für-Schritt-Anleitung

01 Installieren Sie die inferenced CLI

Lade das CLI-Archiv für dein Betriebssystem herunter (v0.2.16 oder neuer) von GitHub releases.

# inferenced CLI herunterladen und installieren
wget https://github.com/gonka-ai/gonka/releases/download/release/v0.2.16-post1/inferenced-linux-amd64.zip
unzip inferenced-linux-amd64.zip
chmod +x inferenced
sudo mv inferenced /usr/local/bin/inferenced

02 Erstellen Sie einen Cold-Wallet-Schlüssel

Das Cold Wallet wird zur Verwaltung des Nodes und zum Empfang von Belohnungen verwendet.

inferenced keys add cold-wallet

Bewahren Sie die mnemonische Phrase an einem sicheren Ort auf!

03 Repository klonen und konfigurieren

git clone https://github.com/gonka-ai/gonka.git -b main
cd gonka/deploy/join
cp config.env.template config.env
# config.env bearbeiten — Ihre Parameter angeben

04 Modellgewichte herunterladen

Aktive Netzwerkmodelle — MoE FP8 (aktuell MiniMax M2.7, DeepSeek V4 Flash und GLM-5.3 Flash; das Set wird durch governance definiert). Laden der Gewichte via HuggingFace CLI. Mehr erfahren →

pip install -U "huggingface_hub[cli]"
# use the current model id from the network config / governance (example: MiniMax M2.7)
huggingface-cli download MiniMaxAI/MiniMax-M2.7

05 Docker-Dienste starten

docker compose -f docker-compose.yml -f docker-compose.mlnode.yml pull
source config.env && docker compose up tmkms node -d --no-deps

06 On-Chain registrieren

Erstellen Sie auf dem Server einen operativen (warmen) Schlüssel und registrieren Sie den Host. Erteilen Sie dann auf dem lokalen Rechner, auf dem der kalte Schlüssel liegt, dem warmen Schlüssel die Rechte für Diensttransaktionen.

# Auf dem Server, im api-Container: einen operativen (warmen) Schlüssel erstellen
docker compose run --rm --no-deps -it api /bin/sh
printf '%s\n%s\n' "$KEYRING_PASSWORD" "$KEYRING_PASSWORD" | inferenced keys add "$KEY_NAME" --keyring-backend file

# Ebenda: den Host im Netzwerk registrieren
inferenced register-new-participant \
    $DAPI_API__PUBLIC_URL \
    $ACCOUNT_PUBKEY \
    --node-address $DAPI_CHAIN_NODE__SEED_API_URL

# Auf dem lokalen Rechner: dem warmen Schlüssel Rechte erteilen (Gebühr 0.002 GNK)
inferenced tx inference grant-ml-ops-permissions \
    cold-wallet <warm-key-address> \
    --from cold-wallet \
    --gas 2000000 --gas-prices 1ngonka \
    --node <seed-api-url>/chain-rpc/

Seit Oktober 2026 (Netzwerk-Update v0.2.16) ist die Rechtevergabe kostenpflichtig: Ohne --gas-prices lehnt das Netzwerk die Transaktion mit dem Fehler insufficient fee ab. Bei --gas 2000000 und einem Preis von 1 ngonka pro Gas beträgt die Gebühr 0.002 GNK. Halten Sie auf dem kalten Wallet einen GNK-Vorrat bereit: Von ihm werden auch die Gebühren des warmen Schlüssels abgebucht — der offizielle Guide empfiehlt, mit 10 GNK zu starten.

07 SSL konfigurieren und starten

DNS konfigurieren (Cloudflare/AWS/GCP/Azure/DO/Hetzner), SSL-Zertifikat erhalten, vollständiges Netzwerk starten und Registrierung überprüfen.

source config.env && \
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml up -d

# Node-Status prüfen
curl http://<PUBLIC_IP>:8000/chain-rpc/status

# Registrierung prüfen
curl http://node2.gonka.ai:8000/v2/participants/<cold-wallet-address>