Inštalácia

Inštalátor podporuje Linux na Debiane alebo Ubuntu (apt). Spúšťajte ho ako root alebo cez sudo; potrebuje aj curl. Elowen vyžaduje Node.js 22.19 alebo novší a inštalátor ho nainštaluje, keď hostiteľ žiadny nemá alebo má starší. Git potrebujete pre Git Projekty a worktree. ripgrep poháňa hľadanie v súboroch a spúšťanie v Linux Sandboxe vyžaduje bubblewrap; oboje inštalátor doinštaluje, ak chýba.

Nainštalujte vydanie

Nainštalujte Elowen. Inštalátor si vyžiada licenčný kľúč skrytým zadaním:

curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh | bash

Kľúč overí skôr, než na hostiteľovi čokoľvek zmení, stiahne licencované vydanie a potom pripraví spravované služby a v tom istom behu spustí sprievodcu nastavením. Sprievodca nastaví prvého administrátora, voliteľný Projekt, poskytovateľa AI a model, Vaše predvoľby a voliteľné embeddingy pamäte a podporu language servera. Na konci vypíše adresu webového rozhrania; elowen otvorí terminálový chat.

Pri inštalácii bez obsluhy nastavte ELOWEN_LICENCE_KEY v prostredí zo svojho úložiska tajomstiev a odovzdajte ELOWEN_INSTALL_ARGS='--unattended …'. Kľúč nikdy nedávajte na príkazový riadok, ani ako KEY=value na tom istom riadku: dostane sa do histórie shellu aj do zoznamu procesov. Ak chcete počítač nastaviť neskôr alebo pomocou prepínačov, spustite elowen setup --non-interactive s povinnými voľbami, ktoré vypíše elowen setup --help.

Ak inštalácia zatiaľ nemá použiteľnú licenciu, aktivujte ju dodatočne príkazom elowen licence activate (kľúč z ELOWEN_LICENCE_KEY alebo zo skrytého zadania, nikdy ako argument príkazu), alebo kľúč zadajte na licenčnej stránke webovej aplikácie. Podrobnosti: Licencia.

Ak si chcete inštalátor pred spustením prezrieť, stiahnite ho najprv, namiesto toho, aby ste ho rovno odovzdali do bash:

curl -fsSL https://<licence-server>/hooks/licensing/v1/install.sh -o install.sh
less install.sh
bash install.sh

Je to ten istý skript ako jednoriadkový príkaz vyššie; stiahnutie vopred mení len to, kedy ho uvidíte.

Inštalátor overí stiahnuté vydanie, pripraví natívne nástroje na zostavenie a nainštaluje presne ten preverený produkčný lock pomocou npm ci. Vydania drží vo verzovaných adresároch a odkaz príkazu prepne atomicky. Balík sa dokončí až po úspešných kontrolách provisionera.

Globálne prepojený vývojový checkout (vytvorený cez npm link) inštalátor nikdy nenahradí a ELOWEN_FORCE to neprebije. Zastaví sa a odporučí aktualizovať checkout na mieste.

Ak je Elowen na počítači už nainštalovaný, inštalátor sa pred preinštalovaním a opätovným pripravením inštancie opýta. Odpoveď „nie“ nechá existujúcu inštaláciu bez zmeny; aktualizujete ju príkazom elowen update. Bez terminálu inštalátor odmietne pokračovať. Preinštalovanie bez otázky zapnete premennou ELOWEN_FORCE=1, napríklad v automatizácii.

Nainštalujte spravované služby

Príkaz vyššie to už urobí. Na hostiteľovi, kde je balík nainštalovaný, ale služby ešte nie sú pripravené, napríklad pri zdrojovom checkoutu, ho spustite priamo:

sudo elowen install

Nastaví používateľa služieb, reverznú proxy, HTTPS a potrebné nástroje behového prostredia a potom spustí sprievodcu nastavením. Možnosti nasadenia si pred schválením zmien v systéme prezrite cez elowen install --help. Pre inštaláciu bez obsluhy odovzdajte --unattended a povinné voľby výslovne.

Miestna inštalácia na hostiteľovi pripraví aj PostgreSQL 18 a vlastný PgBouncer. Ak chcete použiť externú databázu, odovzdajte --database-url: server musí bežať na PostgreSQL 16 alebo novšom, mať v databáze nainštalované rozšírenia vector (0.7 alebo novšie) a pg_trgm, mať pg_stat_statements v shared_preload_libraries a jeho rola musí mať právo vytvárať schémy. URL, ktorá sa k databáze pripája cez TCP, musí obsahovať sslmode=verify-full.

Pripojte počítače pomocou CLI Elowen

Inštalátor nastaví server. Počítač s Linuxom, macOS alebo Windows, na ktorom má Elowen pracovať, sa pripája z webovej aplikácie: na tom počítači otvorte Účet > Počítače a zvoľte Kopírovať inštalačný príkaz. Vo Windows sa príkaz spúšťa v PowerShelli a vyžaduje Windows 10 22H2 alebo Windows 11; v WSL použite linuxový príkaz. Podrobnosti: CLI.

Zostavte zo zdrojového checkoutu

Repozitár jadra je súkromný; licencované vydanie pochádza z licenčného servera, ako je opísané vyššie, nie z verejného klonu. Ak má Vaša organizácia vlastný checkout zdrojových kódov, zostavte ho takto:

npm ci
npm ci --prefix web
npm run build
npm run build:web

npm run build zostaví démona a assety pribalených pluginov. npm run build:web zostaví server webového rozhrania. Na spravovanom zdrojovom checkoutu preinštalujte súbory vlastnené rootom z nového zostavenia; kým nezodpovedajú kódu, démon odmieta privilegované požiadavky:

sudo elowen privileged refresh

Zdrojový kód jadra sa naďalej aktualizuje cez git a nové zostavenie. Pluginy od vydavateľov možno inštalovať, aktualizovať a opravovať bežným katalógom bez toho, aby sa zdrojové jadro nahradilo.

Nainštalujte plugin

Otvorte Nastavenia → Dostupné pluginy a pri plugine zvoľte Inštalovať; prejdite si požadované oprávnenia. Odmietnutie tejto otázky nemení žiadne súbory pluginu. Po schválení plugin ukazuje Vo fronte, kým Elowen pripraví jeho súbory, reštartuje dotknuté služby a overí spustenie. Kým začnete jeho nástroje používať, počkajte na Vykonané. Plugin, ktorý zostane vypnutý, prejde tou istou frontou aj reštartom, ale Elowen nevyžaduje, aby sa pri štarte načítal.

Ak spustenie zlyhá, Elowen zmenu vráti a zobrazí dôvod. Nainštalovaný plugin, ktorý sa nepodarilo načítať, zostane v zozname v Nastavenia → Pluginy so stavom Nenačítané a akciou Opraviť. Priebeh a obnovu opisuje článok Produkcia a aktualizácie.

Spravujte služby

elowen up
elowen down
elowen down --force
elowen status
elowen restart daemon
elowen restart web
elowen restart all
elowen update
elowen doctor

Bežné zastavenie uloží prebiehajúce ťahy. --force ich preruší.

Ďalšie: Docker