Vlastní hosting

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 žá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

Úložiště dat

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 5s časovým limitem zaneprázdnění.

packages/shared/src/db/schema.sql je schéma. Je pouze pro vytváření 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 úložiště 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 s node apps/worker/src/run.mjs, čeká, až bude web zdravý, a sdílí svazek llmeu-data.
• Dva další profily jsou ve výchozím nastavení vypnuté: postgres (postgres:16-alpine) a redis (redis:7-alpine, rezervováno a nečteno cestou kódu v1).
• Profil gpu spouští vllm/vllm-openai s rezervací zařízení NVIDIA a připojuje váhy pouze pro čtení z hostitele; není ve výchozím nastavení povolen, protože tvrdit inference 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 do /app/data, vystavuje 3000 a 8088 a spouští apps/web/server/main.mjs.

Zálohy

node scripts/backup.mjs bez přepínačů zapíše ./backups/llmeu-<stamp>.db. SQLite se kopíruje pomocí VACUUM INTO, nikdy cp, protože živá WAL databáze zkopírovaná pomocí cp může vést k roztržené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 je ověřena předtím, než skript ohlásí úspěch: obnoví se do dočasné kopie, PRAGMA integrity_check musí vrátit ok, schéma se znovu použije a vypíší se počty řádků pro modely, organizace a uživatele.

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

Pošta

Transakční pošta – 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 poštu.

Nasazení bez ani jednoho z nich je podporovaný stav: registrace, přihlášení, změna hesla, týmy a pozvánky fungují, ale pošta pro reset hesla a ověření tam nemůže být zpracována. Stránky to uvádějí a node scripts/db.mjs passwd <email> je cesta k obnově.

Inferenční backendy

Řá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ý mock 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.