Documentation

    Concepts, value, and typical clone scenarios — less code.

    Welcome to Ring
    Quick Reference
    Getting Started
    Prerequisites
    Installation
    First Success Validation
    Next Steps
    Features
    Multi-Vendor Store
    Inventory & Stock
    Vendor Management
    Commissions & Settlements
    SubscriptionConductor
    PaymentConductor
    Payments Overview
    Public Pools & DAO Jars
    WayForPay Payment Integration
    Wallet & Credit System
    WalletConductor
    Affiliate & Referral Enablement
    Referral Codes (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Token Staking System
    Owner Project Lab
    Entities
    Opportunities
    Real-Time Messaging
    Ring Tasks
    WebRTC Calls & STUNner TURN
    Peer Games
    News Module
    Member Blogs
    Public Profile Pages
    Ring File Cabinet
    Username Reservation System
    Scientific Editor
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Email AI-CRM
    Ring Mailer & RingdomX Mail
    Tunnel Protocol
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Security & Compliance
    Admin console
    Admin Wiki
    Manage via Telegram
    Locale System
    Mobile Experience
    Performance Optimization Patterns
    Examples
    Quick Start
    Basic Setup
    White Label
    Custom Branding
    Web3 Integration
    Real World
    Advanced Features
    Customization
    Quick Start — Your First Ring Clone
    Customization Guide
    Branding
    Themes
    Features
    Localization
    Token Economics Setup
    Payment Gateway Integration
    Reference Ring deployments
    Web3
    Token launch jurisdictions
    Wallet
    Wallet Security Tips
    Integrations
    Ethereum wallets (Wagmi v3)
    RingFileBase (object storage API)
    Ring CDN (RingFileBase edge)
    Deployment
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery
    Architecture
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    PaymentConductor architecture
    WalletConductor architecture
    Development
    Ring MCP Server

    Quick entry (CTOs · auditors · agents)

    Welcome — mission & audiences
    Quick Reference
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Security & compliance reads
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)

    Documentation

    Concepts, value, and typical clone scenarios — less code.

    Welcome to Ring
    Quick Reference
    Getting Started
    Prerequisites
    Installation
    First Success Validation
    Next Steps
    Features
    Multi-Vendor Store
    Inventory & Stock
    Vendor Management
    Commissions & Settlements
    SubscriptionConductor
    PaymentConductor
    Payments Overview
    Public Pools & DAO Jars
    WayForPay Payment Integration
    Wallet & Credit System
    WalletConductor
    Affiliate & Referral Enablement
    Referral Codes (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Token Staking System
    Owner Project Lab
    Entities
    Opportunities
    Real-Time Messaging
    Ring Tasks
    WebRTC Calls & STUNner TURN
    Peer Games
    News Module
    Member Blogs
    Public Profile Pages
    Ring File Cabinet
    Username Reservation System
    Scientific Editor
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Email AI-CRM
    Ring Mailer & RingdomX Mail
    Tunnel Protocol
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Security & Compliance
    Admin console
    Admin Wiki
    Manage via Telegram
    Locale System
    Mobile Experience
    Performance Optimization Patterns
    Examples
    Quick Start
    Basic Setup
    White Label
    Custom Branding
    Web3 Integration
    Real World
    Advanced Features
    Customization
    Quick Start — Your First Ring Clone
    Customization Guide
    Branding
    Themes
    Features
    Localization
    Token Economics Setup
    Payment Gateway Integration
    Reference Ring deployments
    Web3
    Token launch jurisdictions
    Wallet
    Wallet Security Tips
    Integrations
    Ethereum wallets (Wagmi v3)
    RingFileBase (object storage API)
    Ring CDN (RingFileBase edge)
    Deployment
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery
    Architecture
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    PaymentConductor architecture
    WalletConductor architecture
    Development
    Ring MCP Server

    Quick entry (CTOs · auditors · agents)

    Welcome — mission & audiences
    Quick Reference
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Security & compliance reads
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)

    Documentation

    Concepts, value, and typical clone scenarios — less code.

    Welcome to Ring
    Quick Reference
    Getting Started
    Prerequisites
    Installation
    First Success Validation
    Next Steps
    Features
    Multi-Vendor Store
    Inventory & Stock
    Vendor Management
    Commissions & Settlements
    SubscriptionConductor
    PaymentConductor
    Payments Overview
    Public Pools & DAO Jars
    WayForPay Payment Integration
    Wallet & Credit System
    WalletConductor
    Affiliate & Referral Enablement
    Referral Codes (Refcodes)
    NFT Exhibition Marketplace
    Solana NFT Gates
    Token Staking System
    Owner Project Lab
    Entities
    Opportunities
    Real-Time Messaging
    Ring Tasks
    WebRTC Calls & STUNner TURN
    Peer Games
    News Module
    Member Blogs
    Public Profile Pages
    Ring File Cabinet
    Username Reservation System
    Scientific Editor
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Email AI-CRM
    Ring Mailer & RingdomX Mail
    Tunnel Protocol
    VideoConductor
    MediaConductor
    Generative Gallery
    Authentication
    Security & Compliance
    Admin console
    Admin Wiki
    Manage via Telegram
    Locale System
    Mobile Experience
    Performance Optimization Patterns
    Examples
    Quick Start
    Basic Setup
    White Label
    Custom Branding
    Web3 Integration
    Real World
    Advanced Features
    Customization
    Quick Start — Your First Ring Clone
    Customization Guide
    Branding
    Themes
    Features
    Localization
    Token Economics Setup
    Payment Gateway Integration
    Reference Ring deployments
    Web3
    Token launch jurisdictions
    Wallet
    Wallet Security Tips
    Integrations
    Ethereum wallets (Wagmi v3)
    RingFileBase (object storage API)
    Ring CDN (RingFileBase edge)
    Deployment
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery
    Architecture
    Data Model
    Security
    Real Time
    Discovery Mutation Sync
    PaymentConductor architecture
    WalletConductor architecture
    Development
    Ring MCP Server

    Quick entry (CTOs · auditors · agents)

    Welcome — mission & audiences
    Quick Reference
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Security & compliance reads
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)
    1. Docs
    2. /Getting Started
    3. /Prerequisites
    Updated Jun 22, 20264 min listen
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Docs
    2. /Getting Started
    3. /Prerequisites
    Updated Jun 22, 20264 min listen
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. Docs
    2. /Getting Started
    3. /Prerequisites
    Updated Jun 22, 20264 min listen
    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Prerequisites

    Filter with Founder / Developer in the docs sidebar. This page lists what you need before Installation. Versions match INSTALL.md, install.sh, and env.local.template — not legacy Node 18 guidance.

    Ring Platform v1.6+ is a Next.js 16 + React 19 app with a mandatory DB_BACKEND_MODE. Production-parity local dev uses PostgreSQL-primary (k8s-postgres-fcm); Firestore-only (firebase-full) is a narrower prototype path.

    At a glance

    RequirementVerified baselineNotes
    Node.jsv20+ (install.sh check; v22+ recommended in INSTALL.md)Custom dev server: node --import tsx server.ts
    npm10+pnpm / yarn also work per installation guide
    GitAny recent versionClone connectplatform/ring
    PostgreSQL14+ (16 Docker image; 18 recommended for Homebrew dev)DB ring_platform, user ring_user
    PostGISOptionalLocation-heavy clones; safe to skip initially
    Disk / RAM~4 GB RAM, ~10 GB free disk for devFull monorepo + node_modules
    Ports3000 (app), 5432 (Postgres)Native WSS on same host via server.ts when self-hosted

    What founders need before ringizing

    You are preparing a white-label clone — branding in ring-config.json, secrets in .env.local, and (for production features) a Postgres database with schema applied.

    MVP vs production-ready

    Explore UI locally

    Node 20+, install.sh --quick, Postgres or short-lived firebase-full prototype — see Database selection.

    Production-parity clone

    Postgres-primary + data/schema.sql v4+ + kingdom migrations — required for store, PaymentConductor, News Kingdom depth.

    Sign-in for testers

    Toolchain

    Node.js and package manager

    install.sh fails early if Node is below v20. Use nvm, fnm, or official installers — see INSTALL.md.

    PostgreSQL

    Default connection (from env.local.template):

    Quick Docker dev database (matches Installation):

    Apply data/schema.sql then kingdom migrations — Database migrations.

    Backend mode (required)

    Set DB_BACKEND_MODE before first boot:

    ValueWhen
    k8s-postgres-fcmDefault — Postgres app data + optional FCM push
    supabase-fcmPostgres on Supabase
    firebase-fullFirestore prototype only

    See . — do not document or set it.

    Next steps

    Installation

    install.sh, schema apply, npm run dev

    First success

    Smoke-test checklist after boot

    Troubleshooting

    Common install failures

    Prerequisites met? Continue to Installation.

    Prerequisites

    Filter with Founder / Developer in the docs sidebar. This page lists what you need before Installation. Versions match INSTALL.md, install.sh, and env.local.template — not legacy Node 18 guidance.

    Ring Platform v1.6+ is a Next.js 16 + React 19 app with a mandatory DB_BACKEND_MODE. Production-parity local dev uses PostgreSQL-primary (k8s-postgres-fcm); Firestore-only (firebase-full) is a narrower prototype path.

    At a glance

    RequirementVerified baselineNotes
    Node.jsv20+ (install.sh check; v22+ recommended in INSTALL.md)Custom dev server: node --import tsx server.ts
    npm10+pnpm / yarn also work per installation guide
    GitAny recent versionClone connectplatform/ring
    PostgreSQL14+ (16 Docker image; 18 recommended for Homebrew dev)DB ring_platform, user ring_user
    PostGISOptionalLocation-heavy clones; safe to skip initially
    Disk / RAM~4 GB RAM, ~10 GB free disk for devFull monorepo + node_modules
    Ports3000 (app), 5432 (Postgres)Native WSS on same host via server.ts when self-hosted

    What founders need before ringizing

    You are preparing a white-label clone — branding in ring-config.json, secrets in .env.local, and (for production features) a Postgres database with schema applied.

    MVP vs production-ready

    Explore UI locally

    Node 20+, install.sh --quick, Postgres or short-lived firebase-full prototype — see Database selection.

    Production-parity clone

    Postgres-primary + data/schema.sql v4+ + kingdom migrations — required for store, PaymentConductor, News Kingdom depth.

    Sign-in for testers

    Toolchain

    Node.js and package manager

    install.sh fails early if Node is below v20. Use nvm, fnm, or official installers — see INSTALL.md.

    PostgreSQL

    Default connection (from env.local.template):

    Quick Docker dev database (matches Installation):

    Apply data/schema.sql then kingdom migrations — Database migrations.

    Backend mode (required)

    Set DB_BACKEND_MODE before first boot:

    ValueWhen
    k8s-postgres-fcmDefault — Postgres app data + optional FCM push
    supabase-fcmPostgres on Supabase
    firebase-fullFirestore prototype only

    See . — do not document or set it.

    Next steps

    Installation

    install.sh, schema apply, npm run dev

    First success

    Smoke-test checklist after boot

    Troubleshooting

    Common install failures

    Prerequisites met? Continue to Installation.

    Prerequisites

    Filter with Founder / Developer in the docs sidebar. This page lists what you need before Installation. Versions match INSTALL.md, install.sh, and env.local.template — not legacy Node 18 guidance.

    Ring Platform v1.6+ is a Next.js 16 + React 19 app with a mandatory DB_BACKEND_MODE. Production-parity local dev uses PostgreSQL-primary (k8s-postgres-fcm); Firestore-only (firebase-full) is a narrower prototype path.

    At a glance

    RequirementVerified baselineNotes
    Node.jsv20+ (install.sh check; v22+ recommended in INSTALL.md)Custom dev server: node --import tsx server.ts
    npm10+pnpm / yarn also work per installation guide
    GitAny recent versionClone connectplatform/ring
    PostgreSQL14+ (16 Docker image; 18 recommended for Homebrew dev)DB ring_platform, user ring_user
    PostGISOptionalLocation-heavy clones; safe to skip initially
    Disk / RAM~4 GB RAM, ~10 GB free disk for devFull monorepo + node_modules
    Ports3000 (app), 5432 (Postgres)Native WSS on same host via server.ts when self-hosted

    What founders need before ringizing

    You are preparing a white-label clone — branding in ring-config.json, secrets in .env.local, and (for production features) a Postgres database with schema applied.

    MVP vs production-ready

    Explore UI locally

    Node 20+, install.sh --quick, Postgres or short-lived firebase-full prototype — see Database selection.

    Production-parity clone

    Postgres-primary + data/schema.sql v4+ + kingdom migrations — required for store, PaymentConductor, News Kingdom depth.

    Sign-in for testers

    Toolchain

    Node.js and package manager

    install.sh fails early if Node is below v20. Use nvm, fnm, or official installers — see INSTALL.md.

    PostgreSQL

    Default connection (from env.local.template):

    Quick Docker dev database (matches Installation):

    Apply data/schema.sql then kingdom migrations — Database migrations.

    Backend mode (required)

    Set DB_BACKEND_MODE before first boot:

    ValueWhen
    k8s-postgres-fcmDefault — Postgres app data + optional FCM push
    supabase-fcmPostgres on Supabase
    firebase-fullFirestore prototype only

    See . — do not document or set it.

    Next steps

    Installation

    install.sh, schema apply, npm run dev

    First success

    Smoke-test checklist after boot

    Troubleshooting

    Common install failures

    Prerequisites met? Continue to Installation.

    At least one Auth.js path: Google OAuth, Apple, or Ring Mailer (SMTP_* or EMAIL_MODE=ethereal).

    Payments later

    WayForPay / Stripe credentials — not required for first npm run dev; add before checkout.

    Honest time budget

    PathTimeOutcome
    ./install.sh --quick + existing Postgres~20–40 minEnv scaffold; you still apply schema + OAuth
    Full Postgres-primary bootstrap45–90 minMatches ring-platform.org dev stack
    firebase-full prototype~15–30 minSkips ERP / conductor depth

    Ringdom-managed hosting skips most of this checklist — settlers receive a configured cluster. Self-hosters on GitHub follow this section (OSS vs enterprise).

    Backend modes
    DATABASE_MODE is removed

    Minimum environment variables

    Providers registered in auth.ts: Ring Mailer Credentials (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple, wallet/crypto credentials. GitHub/Discord OAuth are not in the default provider list. Resend / AUTH_RESEND_KEY removed.

    Optional for later features:

    • BLOB_READ_WRITE_TOKEN — Vercel Blob uploads
    • WAYFORPAY_* / STRIPE_* — PaymentConductor
    • NEXT_PUBLIC_FIREBASE_* + service account — FCM push (not Firestore DB on postgres-primary)
    • OPENAI_API_KEY / ANTHROPIC_API_KEY — AI matcher / Email CRM

    Never commit .env.local. See Environment configuration.

    Validation checklist

    1. 1

      System

    2. 2

      Database

    3. 3

      Health (after install)

      Expect "healthy" when AUTH_SECRET is set. See Monitoring.

    Optional: Docker-only stack

    Docker Compose can run the app + Redis; Postgres is often a separate container or host service. Monitoring profile adds Prometheus/Grafana — see caveats in Monitoring.

    At least one Auth.js path: Google OAuth, Apple, or Ring Mailer (SMTP_* or EMAIL_MODE=ethereal).

    Payments later

    WayForPay / Stripe credentials — not required for first npm run dev; add before checkout.

    Honest time budget

    PathTimeOutcome
    ./install.sh --quick + existing Postgres~20–40 minEnv scaffold; you still apply schema + OAuth
    Full Postgres-primary bootstrap45–90 minMatches ring-platform.org dev stack
    firebase-full prototype~15–30 minSkips ERP / conductor depth

    Ringdom-managed hosting skips most of this checklist — settlers receive a configured cluster. Self-hosters on GitHub follow this section (OSS vs enterprise).

    Backend modes
    DATABASE_MODE is removed

    Minimum environment variables

    Providers registered in auth.ts: Ring Mailer Credentials (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple, wallet/crypto credentials. GitHub/Discord OAuth are not in the default provider list. Resend / AUTH_RESEND_KEY removed.

    Optional for later features:

    • BLOB_READ_WRITE_TOKEN — Vercel Blob uploads
    • WAYFORPAY_* / STRIPE_* — PaymentConductor
    • NEXT_PUBLIC_FIREBASE_* + service account — FCM push (not Firestore DB on postgres-primary)
    • OPENAI_API_KEY / ANTHROPIC_API_KEY — AI matcher / Email CRM

    Never commit .env.local. See Environment configuration.

    Validation checklist

    1. 1

      System

    2. 2

      Database

    3. 3

      Health (after install)

      Expect "healthy" when AUTH_SECRET is set. See Monitoring.

    Optional: Docker-only stack

    Docker Compose can run the app + Redis; Postgres is often a separate container or host service. Monitoring profile adds Prometheus/Grafana — see caveats in Monitoring.

    At least one Auth.js path: Google OAuth, Apple, or Ring Mailer (SMTP_* or EMAIL_MODE=ethereal).

    Payments later

    WayForPay / Stripe credentials — not required for first npm run dev; add before checkout.

    Honest time budget

    PathTimeOutcome
    ./install.sh --quick + existing Postgres~20–40 minEnv scaffold; you still apply schema + OAuth
    Full Postgres-primary bootstrap45–90 minMatches ring-platform.org dev stack
    firebase-full prototype~15–30 minSkips ERP / conductor depth

    Ringdom-managed hosting skips most of this checklist — settlers receive a configured cluster. Self-hosters on GitHub follow this section (OSS vs enterprise).

    Backend modes
    DATABASE_MODE is removed

    Minimum environment variables

    Providers registered in auth.ts: Ring Mailer Credentials (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple, wallet/crypto credentials. GitHub/Discord OAuth are not in the default provider list. Resend / AUTH_RESEND_KEY removed.

    Optional for later features:

    • BLOB_READ_WRITE_TOKEN — Vercel Blob uploads
    • WAYFORPAY_* / STRIPE_* — PaymentConductor
    • NEXT_PUBLIC_FIREBASE_* + service account — FCM push (not Firestore DB on postgres-primary)
    • OPENAI_API_KEY / ANTHROPIC_API_KEY — AI matcher / Email CRM

    Never commit .env.local. See Environment configuration.

    Validation checklist

    1. 1

      System

    2. 2

      Database

    3. 3

      Health (after install)

      Expect "healthy" when AUTH_SECRET is set. See Monitoring.

    Optional: Docker-only stack

    Docker Compose can run the app + Redis; Postgres is often a separate container or host service. Monitoring profile adds Prometheus/Grafana — see caveats in Monitoring.