---
title: "Il-livell web fuq Vercel"
description: "Ħaddem il-livell web ta' Quire fuq Vercel b'worker sieħeb."
image: "https://docs.quirelms.com/og.png"
---

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

# Il-livell web fuq Vercel

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

Id-disinn jinsab f'`docs/architecture/23-ops.md` sezzjoni 5. Vercel imexxi l-livell web
biss. Kull ma hemm ieħor jaħdem fuq host sieħeb li topera int, u mhuwiex
fakultattiv.

## Status f'din ir-release <!--quire:status-in-this-release-->

Il-konfigurazzjoni tinsab f'postha (`apps/web/vercel.json`, il-preset Nitro `vercel`
u l-kontrolli tal-bidu). Vercel jeħtieġ ħażna ta' fajls kondiviża
(`QUIRE_STORAGE_DRIVER=s3` jew `azure`), driver realtime li jaħdem bejn
istanzi tal-funzjonijiet (`QUIRE_REALTIME_DRIVER=sse` jew `centrifugo`) u fornitur tal-email
HTTP. Mingħajrhom il-livell web jirrifjuta li jibda u l-log tiegħu
jsemmi kull setting nieqes.

## Il-biċċiet <!--quire:the-pieces-->

| Piece | Where it runs |
| --- | --- |
| `web` | Vercel Functions, runtime Node: paġni, REST, MCP, LTI, webhooks riċevuti |
| `worker`, `scheduler`, `collab`, `content` | Host sieħeb: Fly, Railway, ECS, jew il-host Docker tiegħek b'`docker/compose.yaml` |
| Postgres | Estern, wara pooler ta' tranżazzjonijiet: Neon, Supabase, jew RDS b'PgBouncer |
| Files | S3 jew R2. M'hemm l-ebda disk persistenti |
| Background jobs | Ikkwodjati b'pg-boss ġewwa t-tranżazzjoni tat-talba, imħaddma mill-worker sieħeb. B'`QUIRE_QUEUE_DRIVER=vercel` fuq il-worker sieħeb, ix-xogħol ħafif (kunsinni ta' notifiki mhux ordnati u webhook) jgħaddi minn Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), biex il-Postgres pooled ma jiġix polled għalihom |
| Recurring jobs | L-iskedar sieħeb. M'hemm l-ebda rotta Vercel Cron, għax cron li jagħmel xogħol ġewwa funzjoni jispiċċa |
| Tracing | OpenTelemetry lejn il-kollettur tiegħek, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## X'dan il-mira ma jistax jagħmel <!--quire:what-this-target-cannot-do-->

Il-livell web jiċċekkja dawn meta jibda u jirrifjuta, billi jsemmi kull problema,
aktar milli jfalli aktar tard mal-ewwel email li qatt ma tintbagħat:

- **Ebda SMTP.** Vercel jimblokka SMTP ħiereġ. Issettja `QUIRE_EMAIL_PROVIDER_CONFIG`
  għal fornitur HTTP (Postmark, SES, Mailgun, SendGrid jew Resend).
  `QUIRE_SMTP_URL` huwa rifjutat.
- **Ebda disk lokali.** `QUIRE_STORAGE_DRIVER=local` huwa rifjutat.
- **Ebda memorja kondiviża bejn invokazzjonijiet.** `QUIRE_REALTIME_DRIVER=inprocess`
  huwa rifjutat. Avvenimenti mibgħuta mis-server huma limitati għat-timeout tal-funzjoni; il-
  klijent jerġa' jikkonnettja b'cursor, biex l-ebda avveniment ma jintilef, iżda l-preżenza hija
  mhux disponibbli.
- **Databases tal-tenant imwaħħla huma limitati** għal madwar tmienja, għax kull waħda hija
  pool ta' konnessjonijiet ieħor f'ambjent li ma jistax jaqsam pools.

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

1. Oħloq proġett Vercel mir-repożitorju b'**Root Directory**
   `apps/web`. `apps/web/vercel.json` jissettja l-kmandi tal-installazzjoni u tal-build
   (`NITRO_PRESET=vercel`) u jservi `/sw.js` mhux cached.
2. Issettja l-varjabbli tal-ambjent. Minn `docker/.env.example`, mill-inqas:
   `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`,
   `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`,
   `DATABASE_URL` (l-indirizz tal-pooler), `QUIRE_REPORT_DATABASE_URL`,
   `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`,
   `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, is-settings tal-ħażna,
   u `QUIRE_COLLAB_URL` u `QUIRE_COLLAB_SIGNING_KEY` li jindikaw lejn is-
   servizz collab tas-sieħeb.
   `QUIRE_REPORT_DATABASE_URL` huwa tad-database fiżika msemmija minn
   `DATABASE_URL`. Għal kull database reġistrata addizzjonali, żid il-URL tal-konnessjoni
   `quire_report` tagħha stess mal-ambjenti kemm tal-web kif ukoll tal-worker, imbagħad
   irreġistra l-isem tal-varjabbli tal-ambjent tagħha bħala `env:NAME` fil-console tal-pjattaforma.
   L-analitika tfalli magħluqa jekk il-URL tar-rapport ta' dik id-database ikun nieqes.
3. Fuq il-host sieħeb, ħaddem `docker/compose.yaml` mingħajr is-servizz `web`,
   bl-istess `docker/.env`:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Il-migrazzjonijiet jaħdmu hemmhekk, qabel ma kull deployment ta' Vercel jiġi promoss.
4. Deployja. Fuq konfigurazzjoni rifjutata l-log tal-funzjoni jibda b'"The web
   tier did not start on vercel" u jelenka kull setting x'tibdel.

## Aġġornament <!--quire:upgrading-->

Emigra mill-host sieħeb l-ewwel, imbagħad ippromwovi d-deployment il-ġdid ta' Vercel,
imbagħad dawwar il-workers tas-sieħeb: l-ordni f'
[upgrade.md](/mt/ops/upgrade/). Rollback istantanju ta' Vercel huwa rollback tal-kodiċi u huwa
dejjem sigur f'release.

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