---
title: "Швидкий старт — ваш перший клон Ring"
description: "Клонування, Postgres-primary бекенд, локальний запуск"
locale: "uk"
---
# Швидкий старт: ваш перший клон Ring

  **Ringdom?** [ringdom.org](https://ringdom.org) — чат на головній. Після handoff: [Посібник кастомізації](/docs/customization/customization-guide.md).

> **Info**
> **Час:** 45–90 хв · **Передумови:** Git, Node.js 20+, Docker опційно.

| Результат | Деталі |
|-----------|--------|
| Локальний додаток | `http://localhost:3000`, `HomeWrapper` |
| Бекенд | `DB_BACKEND_MODE=k8s-postgres-fcm` + PostgreSQL |
| Auth | Auth.js v5 |
| Схема | `data/schema.sql` v4+ і міграції |

```mermaid
flowchart LR
  A[Клон] --> B[env]
  B --> C[Postgres]
  C --> D[міграції]
  D --> E[npm run dev]
```

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

Створює `ring-config.json`, `.env.local` з `DB_BACKEND_MODE=k8s-postgres-fcm`, `AUTH_SECRET`, `npm install`.

{`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`}

{`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`.

PostgreSQL — Docker, Homebrew bootstrap або ваш сервер.

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

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

{`npm run dev`}

- [ ] Головна, `/login`, `/entities` без помилок БД
- [ ] `npm run type-check`

- [ ] Runbook: `DB_BACKEND_MODE` (не `DATABASE_MODE`)
- [ ] Секрети не в git

  
- **[Кастомізація](/docs/customization/customization-guide.md)** — Брендинг і locales

  
- **[Вибір БД](/docs/customization/database-selection.md)** — Режими бекенду

  
- **[Платежі](/docs/customization/payment-integration.md)** — PaymentConductor

> **Success**
> **Клон працює?** `ring-config.json`, `locales/uk/pages.json`, `.reggie-propagate-exclude.json`.