OpportunitiesEntities
Docs
    Ring Platform

    Dezentralisierte selbstbauende Zukunft

    Anmelden
    Entities
    Opportunities
    Store
    Docs
    Plattformkonzepte
    RING ÖkonomieSonoratek LLCGlobaler ImpactKI trifft Web3
    Loslegen
    SchnellstartKalkulatorRoadmap
    Datenschutz|Kontakt
    v1.104.26|Sonoratek LLC

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Mitglieder-Blogs
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Mitglieder-Blogs
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)

    Documentation

    Konzepte, Nutzen und typische Clone-Szenarien — weniger Code.

    Erste Schritte
    Voraussetzungen
    Installation
    Validierung des ersten Erfolgs
    Nächste Schritte
    Funktionen
    Mitglieder-Blogs
    Anpassung
    Ringization playbook
    Deployment
    Selbst gehostetes Deployment
    Architektur
    News-Kingdom-Architektur
    Entwicklung
    OSS und Enterprise

    Schnelleinstieg (CTOs · Auditoren · Agenten)

    Willkommen — Mission & Zielgruppen
    Schnellreferenz
    Erste Schritte
    Architektur & Auth.js
    Backend-Modi & Datenbanken (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Sicherheit & Compliance
    ringdom.org — LegioX-Homebase
    Quellcode — MIT-Lizenz (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring CLI

    Status: Die Ring CLI wird im öffentlichen Repository unter cli/ ausgeliefert. Frühere Dokumentation behauptete, sie sei nur für Enterprise verfügbar. Das stimmt nicht mehr. upgrade, config und test funktionieren für jeden Klon. prod und status erwarten einen Kubernetes-Cluster, den du per SSH erreichst, und Manifeste, die du selbst bereitstellst. Nutze die Tabs Gründer / Entwickler in der Seitenleiste, um diese Seite zu filtern.

    Der Befehl ring ist ein kleines Node.js-Tool (commander, Node 18 oder neuer), das im Layer-1-Repo neben der App liegt: ring/cli/ neben ring/web/. Er erledigt drei Aufgaben: Ring-Updates aus upstream in deinen Klon holen, eine lokale Deploy-Konfiguration pflegen und ein Docker-Image auf Kubernetes ausrollen.

    Frühere Dokumentation sagteAktuelles Repo
    Die CLI ist nicht im öffentlichen GitHub-Repocli/ wird im Repo-Root versioniert und veröffentlicht
    Erst npm link, dann ring --versionFühre npm run cli:install in web/ aus, dann ring --help
    ring deploy prodDer Befehl heißt ring prod. Einen Unterbefehl deploy gibt es nicht
    Die Community nutzt nur SkripteDie Community kann ring upgrade für sichere Merges aus upstream nutzen

    Was die CLI für deinen Klon leistet

    Auf dem neuesten Stand bleiben

    ring upgrade zeigt vorab, welche Ring-Systemdateien sich in upstream geändert haben, und merged sie nur, wenn du es willst.

    Selbst hosten

    Kein Cluster? Nutze install.sh und einen einfachen Node- oder Docker-Host. Die CLI ist optional.

    Verwaltetes Hosting

    Für Ringdom-Siedler wird die Build- und Deploy-Pipeline übernommen.

    Typische Szenarien

    1. Du hast Ring vor Monaten geforkt. Dein Entwickler führt ring upgrade aus, um zu sehen, was sich in upstream geändert hat, prüft den Diff und wendet ihn dann an. Nichts wird automatisch committet.
    2. Du betreibst dein eigenes Kubernetes. Dein Entwickler richtet die CLI auf deinen Control Node, deine Registry und deinen Namespace aus und liefert neue Versionen mit aus.

    Installation

    1. 1

      Binary verlinken

    2. 2

      Auf deine Infrastruktur ausrichten

      Die Konfiguration liegt in ~/.ring-platform.org/config.json und startet mit den Standardwerten aus cli/config.js.

    Befehle (aus cli/index.js)

    BefehlWas er tutWichtigste Optionen
    ring upgradeDrei-Wege-Merge der Systemdateien aus upstream in deinen Klon. Standardmäßig nur Vorschau--apply, --repo <url>, --branch <name>, --force
    ring config~/.ring-platform.org/config.json lesen und schreiben--set k=v, --get k, --list, --reset
    ring testPrüfungen von Datenbank und Services--type db-connection|db-service|user-data|username

    Bekannte Lücken

    Verwandte Dokumentation

    Related documentation

    Community tooling

    Nächster Schritt: die vollständige Liste der öffentlichen Setup-Skripte neben der CLI.

    OSS vs enterprise

    Siehe auch: welche Teile der CLI-Pipeline nur innerhalb von Ringdom laufen.

    Self-hosted deployment

    Gleicher Ablauf: Deployment ohne Kubernetes, bei dem die CLI optional ist.

    1. Docs
    2. /Ring CLI
    Aktualisiert 1. Okt. 20264 Min. Anhören

    Ring CLI

    Status: Die Ring CLI wird im öffentlichen Repository unter cli/ ausgeliefert. Frühere Dokumentation behauptete, sie sei nur für Enterprise verfügbar. Das stimmt nicht mehr. upgrade, config und test funktionieren für jeden Klon. prod und status erwarten einen Kubernetes-Cluster, den du per SSH erreichst, und Manifeste, die du selbst bereitstellst. Nutze die Tabs Gründer / Entwickler in der Seitenleiste, um diese Seite zu filtern.

    Der Befehl ring ist ein kleines Node.js-Tool (commander, Node 18 oder neuer), das im Layer-1-Repo neben der App liegt: ring/cli/ neben ring/web/. Er erledigt drei Aufgaben: Ring-Updates aus upstream in deinen Klon holen, eine lokale Deploy-Konfiguration pflegen und ein Docker-Image auf Kubernetes ausrollen.

    Frühere Dokumentation sagteAktuelles Repo
    Die CLI ist nicht im öffentlichen GitHub-Repocli/ wird im Repo-Root versioniert und veröffentlicht
    Erst npm link, dann ring --versionFühre npm run cli:install in web/ aus, dann ring --help
    ring deploy prodDer Befehl heißt ring prod. Einen Unterbefehl deploy gibt es nicht
    Die Community nutzt nur SkripteDie Community kann ring upgrade für sichere Merges aus upstream nutzen

    Was die CLI für deinen Klon leistet

    Auf dem neuesten Stand bleiben

    ring upgrade zeigt vorab, welche Ring-Systemdateien sich in upstream geändert haben, und merged sie nur, wenn du es willst.

    Selbst hosten

    Kein Cluster? Nutze install.sh und einen einfachen Node- oder Docker-Host. Die CLI ist optional.

    Verwaltetes Hosting

    Für Ringdom-Siedler wird die Build- und Deploy-Pipeline übernommen.

    Typische Szenarien

    1. Du hast Ring vor Monaten geforkt. Dein Entwickler führt ring upgrade aus, um zu sehen, was sich in upstream geändert hat, prüft den Diff und wendet ihn dann an. Nichts wird automatisch committet.
    2. Du betreibst dein eigenes Kubernetes. Dein Entwickler richtet die CLI auf deinen Control Node, deine Registry und deinen Namespace aus und liefert neue Versionen mit aus.

    Installation

    1. 1

      Binary verlinken

    2. 2

      Auf deine Infrastruktur ausrichten

      Die Konfiguration liegt in ~/.ring-platform.org/config.json und startet mit den Standardwerten aus cli/config.js.

    Befehle (aus cli/index.js)

    BefehlWas er tutWichtigste Optionen
    ring upgradeDrei-Wege-Merge der Systemdateien aus upstream in deinen Klon. Standardmäßig nur Vorschau--apply, --repo <url>, --branch <name>, --force
    ring config~/.ring-platform.org/config.json lesen und schreiben--set k=v, --get k, --list, --reset
    ring testPrüfungen von Datenbank und Services--type db-connection|db-service|user-data|username

    Bekannte Lücken

    Verwandte Dokumentation

    Related documentation

    Community tooling

    Nächster Schritt: die vollständige Liste der öffentlichen Setup-Skripte neben der CLI.

    OSS vs enterprise

    Siehe auch: welche Teile der CLI-Pipeline nur innerhalb von Ringdom laufen.

    Self-hosted deployment

    Gleicher Ablauf: Deployment ohne Kubernetes, bei dem die CLI optional ist.

    1. Docs
    2. /Ring CLI
    Aktualisiert 1. Okt. 20264 Min. Anhören

    Ring CLI

    Status: Die Ring CLI wird im öffentlichen Repository unter cli/ ausgeliefert. Frühere Dokumentation behauptete, sie sei nur für Enterprise verfügbar. Das stimmt nicht mehr. upgrade, config und test funktionieren für jeden Klon. prod und status erwarten einen Kubernetes-Cluster, den du per SSH erreichst, und Manifeste, die du selbst bereitstellst. Nutze die Tabs Gründer / Entwickler in der Seitenleiste, um diese Seite zu filtern.

    Der Befehl ring ist ein kleines Node.js-Tool (commander, Node 18 oder neuer), das im Layer-1-Repo neben der App liegt: ring/cli/ neben ring/web/. Er erledigt drei Aufgaben: Ring-Updates aus upstream in deinen Klon holen, eine lokale Deploy-Konfiguration pflegen und ein Docker-Image auf Kubernetes ausrollen.

    Frühere Dokumentation sagteAktuelles Repo
    Die CLI ist nicht im öffentlichen GitHub-Repocli/ wird im Repo-Root versioniert und veröffentlicht
    Erst npm link, dann ring --versionFühre npm run cli:install in web/ aus, dann ring --help
    ring deploy prodDer Befehl heißt ring prod. Einen Unterbefehl deploy gibt es nicht
    Die Community nutzt nur SkripteDie Community kann ring upgrade für sichere Merges aus upstream nutzen

    Was die CLI für deinen Klon leistet

    Auf dem neuesten Stand bleiben

    ring upgrade zeigt vorab, welche Ring-Systemdateien sich in upstream geändert haben, und merged sie nur, wenn du es willst.

    Selbst hosten

    Kein Cluster? Nutze install.sh und einen einfachen Node- oder Docker-Host. Die CLI ist optional.

    Verwaltetes Hosting

    Für Ringdom-Siedler wird die Build- und Deploy-Pipeline übernommen.

    Typische Szenarien

    1. Du hast Ring vor Monaten geforkt. Dein Entwickler führt ring upgrade aus, um zu sehen, was sich in upstream geändert hat, prüft den Diff und wendet ihn dann an. Nichts wird automatisch committet.
    2. Du betreibst dein eigenes Kubernetes. Dein Entwickler richtet die CLI auf deinen Control Node, deine Registry und deinen Namespace aus und liefert neue Versionen mit aus.

    Installation

    1. 1

      Binary verlinken

    2. 2

      Auf deine Infrastruktur ausrichten

      Die Konfiguration liegt in ~/.ring-platform.org/config.json und startet mit den Standardwerten aus cli/config.js.

    Befehle (aus cli/index.js)

    BefehlWas er tutWichtigste Optionen
    ring upgradeDrei-Wege-Merge der Systemdateien aus upstream in deinen Klon. Standardmäßig nur Vorschau--apply, --repo <url>, --branch <name>, --force
    ring config~/.ring-platform.org/config.json lesen und schreiben--set k=v, --get k, --list, --reset
    ring testPrüfungen von Datenbank und Services--type db-connection|db-service|user-data|username

    Bekannte Lücken

    Verwandte Dokumentation

    Related documentation

    Community tooling

    Nächster Schritt: die vollständige Liste der öffentlichen Setup-Skripte neben der CLI.

    OSS vs enterprise

    Siehe auch: welche Teile der CLI-Pipeline nur innerhalb von Ringdom laufen.

    Self-hosted deployment

    Gleicher Ablauf: Deployment ohne Kubernetes, bei dem die CLI optional ist.

    1. Docs
    2. /Ring CLI
    Aktualisiert 1. Okt. 20264 Min. Anhören
    ring prod
  1. Du brauchst nur einen einzigen Server. Lass die CLI weg. Folge der Anleitung zum Selbsthosting.

    2. Ab Werk zeigen die Standardwerte der CLI auf den eigenen Produktionscluster und die Registry von Ringdom. Bitte deinen Entwickler, mit ring config eigene Werte zu setzen, bevor prod oder status laufen.

    ring prodDocker-Build, Push, kubectl apply, set image, Warten auf den Rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, Services und Ingress per SSH, dann GET {app.url}/api/healthkeine

    ring prod hat außerdem --forge-buildkit und --from-forge. Beide steuern den privaten Builder von Ringdom und sind außerhalb davon nicht nützlich.

    So funktioniert ring upgrade

    • Upstream: upgrade.repoUrl ist standardmäßig https://github.com/connectplatform/ring, Branch main, Remote-Name ring-upstream.
    • Basis: der zuletzt synchronisierte upstream-Commit (upgrade.lastSyncedRef). Nur Dateien, die sich zwischen Basis und upstream geändert haben, werden angefasst.
    • Ausschlüsse: Pfade aus .reggie-propagate-exclude.json werden immer übersprungen.
    • Sicherheit: Konflikte bleiben als normale git-Marker stehen. Nichts wird committet. Der Verlauf landet in .ring-upgrade-history.json im git-Root.

    Was ring prod braucht

    EingabeWoher sie kommt
    Image-RepositoryRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (Standard: Ringdom-Registry)
    Manifesteweb/k8s/deployment.yaml, sonst k8s/ im Org-Overlay (cli/paths.js resolveK8sDir). Nicht im öffentlichen Repo
    Cluster-Secrets--apply-k8s-secrets liest RING_K8S_SECRETS_YAML oder k8s/secrets.yaml
    Build-ArgumenteJSON in RING_CLI_SECRETS_PATH (build_args)
    kubectl-Hostk8s.controlNode oder RING_K8S_SSH_HOST für einen einzelnen Lauf

    Führe immer zuerst ring prod --dry-run aus. Es gibt jeden Build-, Push- und kubectl-Befehl aus, ohne ihn auszuführen.

    ring prod
  2. Du brauchst nur einen einzigen Server. Lass die CLI weg. Folge der Anleitung zum Selbsthosting.

    3. Ab Werk zeigen die Standardwerte der CLI auf den eigenen Produktionscluster und die Registry von Ringdom. Bitte deinen Entwickler, mit ring config eigene Werte zu setzen, bevor prod oder status laufen.

    ring prodDocker-Build, Push, kubectl apply, set image, Warten auf den Rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, Services und Ingress per SSH, dann GET {app.url}/api/healthkeine

    ring prod hat außerdem --forge-buildkit und --from-forge. Beide steuern den privaten Builder von Ringdom und sind außerhalb davon nicht nützlich.

    So funktioniert ring upgrade

    • Upstream: upgrade.repoUrl ist standardmäßig https://github.com/connectplatform/ring, Branch main, Remote-Name ring-upstream.
    • Basis: der zuletzt synchronisierte upstream-Commit (upgrade.lastSyncedRef). Nur Dateien, die sich zwischen Basis und upstream geändert haben, werden angefasst.
    • Ausschlüsse: Pfade aus .reggie-propagate-exclude.json werden immer übersprungen.
    • Sicherheit: Konflikte bleiben als normale git-Marker stehen. Nichts wird committet. Der Verlauf landet in .ring-upgrade-history.json im git-Root.

    Was ring prod braucht

    EingabeWoher sie kommt
    Image-RepositoryRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (Standard: Ringdom-Registry)
    Manifesteweb/k8s/deployment.yaml, sonst k8s/ im Org-Overlay (cli/paths.js resolveK8sDir). Nicht im öffentlichen Repo
    Cluster-Secrets--apply-k8s-secrets liest RING_K8S_SECRETS_YAML oder k8s/secrets.yaml
    Build-ArgumenteJSON in RING_CLI_SECRETS_PATH (build_args)
    kubectl-Hostk8s.controlNode oder RING_K8S_SSH_HOST für einen einzelnen Lauf

    Führe immer zuerst ring prod --dry-run aus. Es gibt jeden Build-, Push- und kubectl-Befehl aus, ohne ihn auszuführen.

    ring prod
  3. Du brauchst nur einen einzigen Server. Lass die CLI weg. Folge der Anleitung zum Selbsthosting.

    4. Ab Werk zeigen die Standardwerte der CLI auf den eigenen Produktionscluster und die Registry von Ringdom. Bitte deinen Entwickler, mit ring config eigene Werte zu setzen, bevor prod oder status laufen.

    ring prodDocker-Build, Push, kubectl apply, set image, Warten auf den Rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, Services und Ingress per SSH, dann GET {app.url}/api/healthkeine

    ring prod hat außerdem --forge-buildkit und --from-forge. Beide steuern den privaten Builder von Ringdom und sind außerhalb davon nicht nützlich.

    So funktioniert ring upgrade

    • Upstream: upgrade.repoUrl ist standardmäßig https://github.com/connectplatform/ring, Branch main, Remote-Name ring-upstream.
    • Basis: der zuletzt synchronisierte upstream-Commit (upgrade.lastSyncedRef). Nur Dateien, die sich zwischen Basis und upstream geändert haben, werden angefasst.
    • Ausschlüsse: Pfade aus .reggie-propagate-exclude.json werden immer übersprungen.
    • Sicherheit: Konflikte bleiben als normale git-Marker stehen. Nichts wird committet. Der Verlauf landet in .ring-upgrade-history.json im git-Root.

    Was ring prod braucht

    EingabeWoher sie kommt
    Image-RepositoryRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (Standard: Ringdom-Registry)
    Manifesteweb/k8s/deployment.yaml, sonst k8s/ im Org-Overlay (cli/paths.js resolveK8sDir). Nicht im öffentlichen Repo
    Cluster-Secrets--apply-k8s-secrets liest RING_K8S_SECRETS_YAML oder k8s/secrets.yaml
    Build-ArgumenteJSON in RING_CLI_SECRETS_PATH (build_args)
    kubectl-Hostk8s.controlNode oder RING_K8S_SSH_HOST für einen einzelnen Lauf

    Führe immer zuerst ring prod --dry-run aus. Es gibt jeden Build-, Push- und kubectl-Befehl aus, ohne ihn auszuführen.