---
title: "Быстрый старт — ваш первый клон Ring"
description: "Клонируйте, настройте Postgres-primary бэкенд и запустите локально через install.sh или вручную"
locale: "ru"
---
# Быстрый старт: ваш первый клон Ring

  **Хостинг под управлением Ringdom?** [ringdom.org](https://ringdom.org) — опишите платформу в чате на главной. После handoff используйте [Customization guide](/docs/customization/customization-guide.md).

> **Info**
> **Время:** 45–90 минут · **Требования:** Git, Node.js 20+, Docker опционально для Postgres.

| Результат | Детали |
|---------|---------|
| Локальное приложение | `http://localhost:3000` через `HomeWrapper` |
| Бэкенд | `DB_BACKEND_MODE=k8s-postgres-fcm` + PostgreSQL |
| Auth | Auth.js v5 — `AUTH_SECRET` + один OAuth-провайдер |
| Схема | `data/schema.sql` v4+ и kingdom-миграции |
| Конфиг | `ring-config.json` + `.env.local` |

```mermaid
flowchart LR
  A[Clone] --> B[env + ring-config]
  B --> C[PostgreSQL]
  C --> D[migrations]
  D --> E[npm run dev]
  E --> F[Smoke test]
```

**Рекомендуется** — из чистой директории:

{`git clone https://github.com/connectplatform/ring.git
cd ring
chmod +x install.sh
./install.sh --quick`}

`install.sh` v2.0:

- Создаёт **`ring-config.json`** из шаблона
- Копирует **`env.local.template`** → `.env.local` (включая `DB_BACKEND_MODE=k8s-postgres-fcm`)
- Генерирует `AUTH_SECRET` / ключи кошелька
- Запускает `npm install`

Флаги: `--clone-name my-ring`, `--quick`, `--help`. См. `INSTALL.md`.

Клонируйте и установите зависимости:

{`git clone https://github.com/connectplatform/ring.git
cd ring
npm install
cp env.local.template .env.local
cp ring-config.template.json ring-config.json`}

Отредактируйте `ring-config.json` — `clone.displayName`, `domains.development`, `features`.

Задайте **обязательный** режим бэкенда:

{`DB_BACKEND_MODE=k8s-postgres-fcm
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ring_platform
DB_USER=ring_user
DB_PASSWORD=ring_password_2024`}

> **Warning**
> **Не** используйте устаревшие `DATABASE_MODE=firebase_only` или `postgresql_only`.

Другие режимы: [Database selection](/docs/customization/database-selection.md).

**PostgreSQL** — Docker (`docker-compose.dev.yml`), Homebrew-bootstrap (`./infrastructure/postgres/bootstrap-brew-dev.sh`) или существующий сервер.

Примените миграции:

{`export DATABASE_URL="postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}"
./scripts/run-migration.sh`}

Полный порядок: [Database migrations](/docs/getting-started/migrations.md).

Минимум для Auth:

{`AUTH_SECRET=
AUTH_GOOGLE_ID=
AUTH_GOOGLE_SECRET=
NEXT_PUBLIC_BASE_URL=http://localhost:3000`}

Локали (значения по умолчанию подходят):

{`NEXT_PUBLIC_SUPPORTED_LOCALES=en,uk,ru
NEXT_PUBLIC_DEFAULT_LOCALE=en`}

{`npm run dev`}

Откройте [http://localhost:3000](http://localhost:3000) — главная через `components/wrappers/home-wrapper.tsx`.

## Чеклист smoke-теста

- [ ] Home — `locales/{locale}/pages.json` → `pages.home`
- [ ] `/login` — OAuth работает
- [ ] `/entities`, `/opportunities` — нет ошибок DB adapter
- [ ] `npm run type-check` проходит

- [ ] Runbook фиксирует `DB_BACKEND_MODE` (не `DATABASE_MODE`)
- [ ] Миграции соответствуют списку `data/migrations/`
- [ ] Переменные FCM — только если включён push
- [ ] Секреты в k8s / vault — никогда не коммитьте `.env.local`

## Краткий план production

[Self-hosted deployment](/docs/deployment/self-hosted.md) — Docker или `npm run build && npm start`.

[Environment](/docs/deployment/environment.md) — PaymentConductor, FCM, ключи PSP.

Settler'ы Ringdom: чат на [ringdom.org](https://ringdom.org) — этот Quick Start пропускайте.

> **Warning**
> **Не рекомендуется для полного v1.6:** только Vercel + `firebase-full`. Production по умолчанию: **`k8s-postgres-fcm`** на вашем кластере.

  
- **[Customization guide](/docs/customization/customization-guide.md)** — Брендинг, HomeWrapper, локали

  
- **[Database selection](/docs/customization/database-selection.md)** — Матрица `DB_BACKEND_MODE`

  
- **[Payment integration](/docs/customization/payment-integration.md)** — Настройка PaymentConductor

  
- **[Architecture hub](/docs/architecture.md)** — Внутреннее устройство системы

> **Success**
> **Клон запущен?** Отредактируйте `ring-config.json` и `locales/en/pages.json`, затем `.reggie-propagate-exclude.json` перед propagation Reggie.