Vlastní hostování

Node a zapisovatelný adresář jsou celý požadavek. Níže uvedená tvrzení byla přečtena ze souborů uvedených vedle nich; cokoli, co nebylo možné potvrdit, zde není.

Vstupní body

• package.json vyžaduje Node >= 22.5. Úložiště SQLite je vlastní modul Node node:sqlite.
• Neexistuje vůbec žádný seznam závislostí: aplikace, balíčky, skripty a testy běží na standardní knihovně Node a Dockerfile nic neinstaluje.
• Existují tři procesy; každý otevírá databázi a při spuštění spouští migraci.

node apps/web/server/main.mjs                   # hub + console + embedded API
API_EMBED=false node apps/api/src/main.mjs    # API only, no pages
node apps/worker/src/run.mjs                  # probes, latency, rollup, housekeeping

Datové úložiště

DATABASE_URL=sqlite:./data/llmeu.db nepotřebuje server a adresář a soubor se vytvoří při prvním otevření. Handle běží v režimu WAL se zapnutými cizími klíči a pětisekundovým časovým limitem zaneprázdnění.

packages/shared/src/db/schema.sql je schéma. Je pouze vytvářecí a idempotentní, takže opětovné spuštění je bezpečné; sloupec přidaný do existující tabulky musí být také deklarován v aditivním kroku v packages/shared/src/db/index.mjs.

Operátorské CLI

node scripts/db.mjs čte DATABASE_URL a nepotřebuje žádné služby. Příkazy:

Prostředí

Seskupeno tak, jak je seskupuje .env.example.

Docker

Compose a image jsou volitelné: vlastní sada testů repozitáře nevyžaduje Docker a primární cestou je lokální proces bez služeb.

• Výchozí profil spouští web: porty 3000 a 8088, SQLite na svazku llmeu-data v /app/data, vestavěné API a healthcheck na /healthz.
• Stejný image spouští worker pomocí node apps/worker/src/run.mjs, čeká, až web bude zdravý, a sdílí svazek llmeu-data.
• Dva dodatečné profily jsou ve výchozím nastavení vypnuté: postgres (postgres:16-alpine) a redis (redis:7-alpine, rezervovaný a nečtený cestou kódu v1).
• Profil gpu spouští vllm/vllm-openai s rezervací zařízení NVIDIA a připojuje váhy z hostitele pouze pro čtení; není ve výchozím nastavení povolen, protože tvrdit inferenci v EU bez GPU by bylo nepravdivé.
• Dockerfile je FROM node:24-alpine s tini, bez kroku sestavení a bez instalace závislostí, běží jako uživatel node, zapisuje pouze pod /app/data, vystavuje 3000 a 8088 a spouští apps/web/server/main.mjs.

Zálohy

node scripts/backup.mjs bez přepínačů zapisuje ./backups/llmeu-<stamp>.db. SQLite se kopíruje pomocí VACUUM INTO, nikdy cp, protože živá databáze WAL zkopírovaná pomocí cp může vést k poškozenému nebo zastaralému stavu.

node scripts/backup.mjs                                  # ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --out /srv/backups/              # explicit destination
node scripts/backup.mjs --verify ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --restore ./backups/llmeu-<stamp>.db --yes
node scripts/backup.mjs --list

Každá záloha SQLite se před ohlášením úspěchu skriptem ověří: obnoví se do dočasné kopie, PRAGMA integrity_check musí vrátit ok, schéma se znovu aplikuje a vypíšou se počty řádků pro modely, organizace a uživatele.

S URL postgres:// skript používá pg_dump --format=custom a potřebuje pg_dump v PATH; dump nelze otevřít jako databázi, takže jeho počty řádků vyžadují zkušební obnovení.

E-mail

Transakční e-mail — reset hesla, ověření adresy, pozvánky — používá MAIL_SMTP_* nebo MAIL_API_URL s MAIL_FROM. Transport se volí jednou při spuštění a je uveden na každé stránce, která potřebuje e-mail.

Nasazení bez ani jednoho je podporovaný stav: registrace, přihlášení, změna hesla, týmy a pozvánky fungují, ale e-mail pro reset hesla a ověření tam nelze zpracovat. Stránky to uvádějí a node scripts/db.mjs passwd <email> je cesta k obnovení.

Backendy inference

Řádek koncového bodu pojmenovává runtime a region a registr backendů vybírá adaptér podle regionu, takže na koncový bod může odpovědět pouze stroj v regionu, který pojmenovává.

• INFERENCE_MOCK=true zachovává deterministický vývojový backend, který nepotřebuje GPU ani váhy.
• GPU_ENABLED=false vylučuje spravované backendy; při GPU_ENABLED=true se VLLM_BASE_URL vztahuje na jediný region pojmenovaný VLLM_REGION.
• Nasazení s několika regiony nastavuje jednu proměnnou na region, pojmenovanou podle slugu regionu (například VLLM_BASE_URL_DE_FRA). Koncový bod v regionu bez nakonfigurovaného backendu je odmítnut, místo aby byl obsloužen ze stroje v jiném regionu.
• Partnerské backendy pocházejí z PARTNER_BASE_URL_<REGION> a přebírají PARTNER_SOVEREIGNTY a PARTNER_API_KEY; server povoluje použití partnera, když je nastaveno PARTNER_BASE_URL.