---
title: "Ọkwa weebụ na Vercel"
description: "Gbaa ọkwa weebụ Quire na Vercel tinyere worker ibe."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ig/llms.txt
> Use this file to discover all available pages before exploring further.

# Ọkwa weebụ na Vercel

<span id="the-web-tier-on-vercel"></span>

Nhazi ahụ dị na `docs/architecture/23-ops.md` ngalaba 5. Vercel na-agba naanị
ọkwa weebụ. Ihe ọ bụla ọzọ na-agba na họst ibe ị na-elekọta, ọ dịghịkwa
nhọrọ ịhapụ ya.

## Ọnọdụ na mwepụta a <!--quire:status-in-this-release-->

Nhazi ahụ adịlarị (`apps/web/vercel.json`, nhazi Nitro `vercel` na nlele
mmalite). Vercel chọrọ usoro nchekwa faịlụ ọnụ (`QUIRE_STORAGE_DRIVER=s3` ma
ọ bụ `azure`), usoro ozi ozugbo na-arụ ọrụ gafee function dị iche iche
(`QUIRE_REALTIME_DRIVER=sse` ma ọ bụ `centrifugo`) na onye na-enye email site
na HTTP. Na-enweghị ha ọkwa weebụ jụrụ ịmalite, ndekọ ya akpọkwa ntọala
ọ bụla na-efu.

## Akụkụ dị iche iche <!--quire:the-pieces-->

| Akụkụ | Ebe ọ na-agba |
| --- | --- |
| `web` | Vercel Functions, Bun runtime: peeji, REST, MCP, LTI, webhook anatara |
| `worker`, `scheduler`, `collab`, `content` | Họst ibe: Fly, Railway, ECS, ma ọ bụ họst Docker nke gị na `docker/compose.yaml` |
| Postgres | N'èzí, n'azụ ọdọ mmiri transaction: Neon, Supabase, ma ọ bụ RDS na PgBouncer |
| Faịlụ | S3 ma ọ bụ R2. Enweghị disk na-adịgide |
| Ọrụ ndabere | A na-etinye ha n'ahịrị site na pg-boss n'ime transaction arịrịọ ahụ, worker ibe na-agba ha. Na `QUIRE_QUEUE_DRIVER=vercel` na worker ibe, ọrụ dị mfe (nnyefe ngosi na webhook na-enweghị usoro) na-aga site na Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), ka a ghara ịjụ Postgres ọdọ mmiri ajụjụ maka ha |
| Ọrụ na-eme ugboro ugboro | Onye nhazi oge ibe. Enweghị ụzọ Vercel Cron, n'ihi na cron na-arụ ọrụ n'ime function na-agwụ oge |
| Nsochi | OpenTelemetry gaa na onye nchịkọta gị, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## Ihe ebumnobi a enweghị ike ime <!--quire:what-this-target-cannot-do-->

Ọkwa weebụ na-enyocha ihe ndị a mgbe ọ malitere wee jụ, na-akpọ nsogbu
ọ bụla, kama ịda ma e mesịrị na email mbụ na-ezigaghị:

- **Enweghị SMTP.** Vercel na-egbochi SMTP na-apụ apụ. Tọọ
  `QUIRE_EMAIL_PROVIDER_CONFIG` na onye na-enye ọrụ site na HTTP (Postmark,
  SES, Mailgun, SendGrid ma ọ bụ Resend). A jụrụ `QUIRE_SMTP_URL`.
- **Enweghị disk mpaghara.** A jụrụ `QUIRE_STORAGE_DRIVER=local`.
- **Enweghị ncheta ọnụ n'etiti oku.** A jụrụ
  `QUIRE_REALTIME_DRIVER=inprocess`. A na-akwụsị ihe omume sava zitere na
  oge function; onye ahịa na-ejikọta ọzọ na cursor, ka ihe omume ọ bụla ghara
  ịla n'iyi, mana ọnụnọ adịghị.
- **A na-akwụsị nchekwa data tenant a tụkwasịrị** ihe dị ka asatọ, n'ihi na nke
  ọ bụla bụ ọdọ mmiri njikọ ọzọ na gburugburu na-enweghị ike ịkekọrịta
  ọdọ mmiri.

## Mbunye <!--quire:deploying-->

1. Mepụta ọrụ Vercel site na ebe nchekwa na **Root Directory** `apps/web`.
   `apps/web/vercel.json` na-atọ iwu wụnye na wuo (`NITRO_PRESET=vercel`) ma
   na-enye `/sw.js` na-enweghị cache.
2. Tọọ mgbanwe gburugburu. Site na `docker/.env.example`, ọ dịkarịa ala:
   `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`,
   `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`,
   `DATABASE_URL` (adreesị ọdọ mmiri), `QUIRE_REPORT_DATABASE_URL`,
   `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`,
   `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, ntọala nchekwa,
   na `QUIRE_COLLAB_URL` na `QUIRE_COLLAB_SIGNING_KEY` na-atụ aka na ọrụ
   collab ibe.
   `QUIRE_REPORT_DATABASE_URL` bụ nke nchekwa data anụ ahụ `DATABASE_URL`
   kpọrọ. Maka nchekwa data ọ bụla ọzọ edebanyere aha, tinye URL njikọ
   `quire_report` nke ya na gburugburu weebụ na worker abụọ, debanyekwa aha
   mgbanwe gburugburu ya dịka `env:NAME` na console platform. Analytics
   na-emechi emechi ma URL akụkọ nchekwa data ahụ efu.
3. Na họst ibe, gbaa `docker/compose.yaml` na-enweghị ọrụ `web`, na otu
   `docker/.env`:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Mbugharị na-agba ebe ahụ, tupu e kwalite mbunye Vercel ọ bụla.
4. Bunye. Na nhazi a jụrụ, ndekọ function na-amalite na "The web
   tier did not start on vercel" wee depụta ntọala ọ bụla ịgbanwe.

## Mmelite <!--quire:upgrading-->

Bugharịa site na họst ibe nke mbụ, kwalitekwa mbunye Vercel ọhụrụ,
gbanweekwa workers ibe: usoro dị na [upgrade.md](/ig/ops/upgrade/). Ịlaghachi
Vercel ozugbo bụ ịlaghachi koodu, ọ dịkwa mma mgbe niile n'ime mwepụta.

Source: https://docs.quirelms.com/ig/ops/vercel/index.mdx