Instalace

Instalátor podporuje Linux na Debianu nebo Ubuntu (apt). Spouštějte ho jako root nebo přes sudo; potřebuje také curl. Elowen vyžaduje Node.js 22.19 nebo novější a instalátor ho nainstaluje, když hostitel žádný nemá nebo má starší. Git potřebujete pro Git Projekty a worktree. ripgrep pohání hledání v souborech a spouštění v Linux Sandboxu vyžaduje bubblewrap; obojí instalátor doinstaluje, pokud chybí.

Nainstalujte vydání

Nainstalujte Elowen. Instalátor si vyžádá licenční klíč skrytým zadáním:

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

Klíč ověří dřív, než na hostiteli něco změní, stáhne licencované vydání a potom připraví spravované služby a v témže běhu spustí průvodce nastavením. Průvodce nastaví prvního administrátora, volitelný Projekt, poskytovatele AI a model, Vaše předvolby a volitelné embeddingy paměti a podporu language serveru. Na konci vypíše adresu webového rozhraní; elowen otevře terminálový chat.

Při instalaci bez obsluhy nastavte ELOWEN_LICENCE_KEY v prostředí ze svého úložiště tajemství a předejte ELOWEN_INSTALL_ARGS='--unattended …'. Klíč nikdy nedávejte na příkazový řádek, ani jako KEY=value na témže řádku: dostane se do historie shellu i do seznamu procesů. Když chcete počítač nastavit později nebo pomocí přepínačů, spusťte elowen setup --non-interactive s povinnými volbami, které vypíše elowen setup --help.

Pokud instalace zatím nemá použitelnou licenci, aktivujte ji dodatečně příkazem elowen licence activate (klíč z ELOWEN_LICENCE_KEY nebo ze skrytého zadání, nikdy jako argument příkazu), nebo klíč zadejte na licenční stránce webové aplikace. Podrobnosti: Licence.

Pokud si chcete instalátor před spuštěním prohlédnout, stáhněte ho nejdřív, místo abyste ho rovnou předávali do bash:

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

Je to stejný skript jako jednořádkový příkaz výše; stažení předem mění jen to, kdy ho uvidíte.

Instalátor ověří stažené vydání, připraví nativní nástroje pro sestavení a nainstaluje přesně ten prověřený produkční lock pomocí npm ci. Vydání drží ve verzovaných adresářích a odkaz příkazu přepne atomicky. Balíček se dokončí až po úspěšných kontrolách provisioneru.

Globálně propojený vývojový checkout (vytvořený přes npm link) instalátor nikdy nenahradí a ELOWEN_FORCE to nepřebije. Zastaví se a doporučí aktualizovat checkout na místě.

Pokud je Elowen na počítači už nainstalovaný, instalátor se před přeinstalováním a opětovným připravením instance zeptá. Odpověď „ne“ nechá stávající instalaci beze změny; aktualizujete ji příkazem elowen update. Bez terminálu instalátor odmítne pokračovat. Přeinstalaci bez otázky zapnete proměnnou ELOWEN_FORCE=1, například v automatizaci.

Nainstalujte spravované služby

Příkaz výše to už udělá. Na hostiteli, kde je balíček nainstalovaný, ale služby ještě nejsou připravené, například u zdrojového checkoutu, ho spusťte přímo:

sudo elowen install

Nastaví uživatele služeb, reverzní proxy, HTTPS a potřebné nástroje běhového prostředí a potom spustí průvodce nastavením. Možnosti nasazení si před schválením změn v systému prohlédněte přes elowen install --help. Pro instalaci bez obsluhy předejte --unattended a povinné volby výslovně.

Místní instalace na hostiteli připraví také PostgreSQL 18 a vlastní PgBouncer. Pokud chcete použít externí databázi, předejte --database-url: server musí běžet na PostgreSQL 16 nebo novějším, mít v databázi nainstalovaná rozšíření vector (0.7 nebo novější) a pg_trgm, mít pg_stat_statements v shared_preload_libraries a jeho role musí mít právo vytvářet schémata. URL, která se k databázi připojuje přes TCP, musí obsahovat sslmode=verify-full.

Připojte počítače pomocí CLI Elowen

Instalátor nastaví server. Počítač s Linuxem, macOS nebo Windows, na kterém má Elowen pracovat, se připojuje z webové aplikace: na tom počítači otevřete Účet > Počítače a zvolte Kopírovat instalační příkaz. Ve Windows se příkaz spouští v PowerShellu a vyžaduje Windows 10 22H2 nebo Windows 11; v WSL použijte linuxový příkaz. Podrobnosti: CLI.

Sestavte ze zdrojového checkoutu

Repozitář jádra je soukromý; licencované vydání pochází z licenčního serveru, jak je popsáno výše, ne z veřejného klonu. Pokud má Vaše organizace vlastní checkout zdrojových kódů, sestavte ho takto:

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

npm run build sestaví démona a assety přibalených pluginů. npm run build:web sestaví server webového rozhraní. Na spravovaném zdrojovém checkoutu přeinstalujte soubory vlastněné rootem z nového sestavení; dokud neodpovídají kódu, démon odmítá privilegované požadavky:

sudo elowen privileged refresh

Zdrojový kód jádra se nadále aktualizuje přes git a nové sestavení. Pluginy od vydavatelů lze instalovat, aktualizovat a opravovat běžným katalogem, aniž by se zdrojové jádro nahradilo.

Nainstalujte plugin

Otevřete Nastavení → Dostupné pluginy a u pluginu zvolte Instalovat; projděte si požadovaná oprávnění. Odmítnutí této otázky nemění žádné soubory pluginu. Po schválení plugin ukazuje Ve frontě, dokud Elowen připraví jeho soubory, restartuje dotčené služby a ověří spuštění. Než začnete jeho nástroje používat, počkejte na Provedeno. Plugin, který zůstane vypnutý, projde stejnou frontou i restartem, ale Elowen nevyžaduje, aby se při startu načetl.

Pokud spuštění selže, Elowen změnu vrátí a zobrazí důvod. Nainstalovaný plugin, který se nepodařilo načíst, zůstane v seznamu v Nastavení → Pluginy se stavem Nenačteno a akcí Opravit. Průběh a obnovu popisuje článek Produkce a aktualizace.

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

Běžné zastavení uloží probíhající tahy. --force je přeruší.

Další: Docker