Inštalácia na Debian a Ubuntu¶

Hardvérové požiadavky¶

Weblate by mal bez problémov bežať na akomkoľvek súčasnom hardvéri, nasledujúca je minimálna konfigurácia potrebná na spustenie Weblate na jednom hostiteľovi (Weblate, databáza a webový server):

3 GB RAM
2 jadrá CPU
1 GB úložného priestoru

Poznámka

Skutočné požiadavky pre vašu inštaláciu Weblate sa výrazne líšia v závislosti od veľkosti prekladov v nej spravovaných.

Využitie pamäte¶

Čím viac pamäte, tým lepšie - používa sa na cacheovanie na všetkých úrovniach (súborový systém, databáza a Weblate). Pre stovky prekladových komponentov sa odporúča aspoň 4 GB RAM.

Rada

Pre systémy s menším množstvom pamäte, než sa odporúča, sa odporúča Nastavenie Celery s jedným procesom.

Využitie CPU¶

Veľa súbežných používateľov zvyšuje počet potrebných jadier CPU.

Weblate 2026.8 zaviedol NumPy ako povinnú závislosť. Na systémoch x86-64 vyžaduje optimalizovaný build NumPy pribalený v obraze Docker CPU kompatibilné s x86-64-v2. Bez požadovaných funkcií CPU sa NumPy nepodarí načítať a Weblate sa nespustí.

Pred aktualizáciou skontrolujte požadovanú funkciu CPU SSE4.2 na Linux systéme spúšťajúcom Docker:

grep sse4_2 /proc/cpuinfo

Prázdny výstup indikuje, že požadovaná funkcia CPU nie je dostupná. Toto je predbežná kontrola; nájdenie SSE4.2 neoveruje všetky funkcie CPU x86-64-v2.

Ak Docker beží vo virtuálnom stroji, spustite kontrolu vnútri hosťa. Virtuálne stroje môžu skrývať funkcie CPU podporované hostiteľom. Nakonfigurujte virtuálny stroj tak, aby vystavoval požadované funkcie CPU hostiteľa, potom reštartujte hosťa. Ak fyzický CPU nemá požadované funkcie, povyšte hardvér.

Využitie úložiska¶

Typické využitie úložiska databázy je okolo 300 MB na 1 milión hosťovaných slov.

Potrebný úložný priestor pre klonované repozitáre sa líši, ale Weblate sa snaží udržiavať ich veľkosť minimálnu pomocou plytkých klonov.

Výkon úložiska¶

Operácie správy verzií vykonávajú množstvo vyhľadávaní metadátových súborov. Podadresár vcs v DATA_DIR preto potrebuje nízku latenciu čítania; úložisko s pomalým prístupom k metadátam môže spôsobiť, že operácie ako git status budú trvať dlho, aj keď je jeho priepustnosť pre hromadné dáta dobrá. Ak je to možné, uchovávajte CACHE_DIR na lokálnom alebo dočasnom úložisku s nízkou latenciou.

Kontroly nasadenia merajú latenciu vyhľadávania metadát pre obe umiestnenia a varujú, ak medián latencie presiahne 10 milisekúnd. Ide o približné meranie v danom časovom bode ovplyvnené záťažou súborového systému a systému. Pred zmenou konfigurácie úložiska znova spustite weblate check --deploy.

Uzly¶

Pre malé a stredne veľké stránky (milióny hosťovaných slov) môžu byť všetky komponenty Weblate (pozrite Prehľad architektúry) spustené na jednom uzle.

Keď narastiete na stovky miliónov hosťovaných slov, odporúča sa mať vyhradený uzol pre databázu (pozrite Nastavenie databázy pre Weblate).

Inštalácia¶

Systémové požiadavky¶

Nainštalujte závislosti potrebné na zostavenie Python modulov (pozrite Softvérové požiadavky):

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev \
   libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev git

Nainštalujte požadované voliteľné závislosti v závislosti od funkcií, ktoré plánujete používať (pozrite Závislosti Pythonu):

apt install -y \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

Voliteľne nainštalujte softvér na spúšťanie produkčného servera, pozrite Spúšťanie servera, Nastavenie databázy pre Weblate, Úlohy na pozadí pomocou Celery. V závislosti od veľkosti vašej inštalácie môžete chcieť spustiť tieto komponenty na vyhradených serveroch.

Lokálne inštalačné inštrukcie:

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Valkey
apt install -y valkey-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

# Gettext tools for gettext POT/PO update add-ons
apt install -y gettext

Správca balíkov uv¶

Rada

Na inštaláciu Weblate používame správcu balíkov uv.

curl -LsSf https://astral.sh/uv/install.sh | sh

Viď aj

Inštalácia uv

Python moduly¶

Rada

Inštalujeme Weblate v samostatnom Python prostredí.

Vytvorte Python prostredie pre Weblate:
```
uv venv ~/weblate-env
```
Aktivujte Python prostredie pre Weblate:
```
. ~/weblate-env/bin/activate
```
Nainštalujte Weblate vrátane všetkých voliteľných závislostí:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Prosím, skontrolujte Závislosti Pythonu pre jemné doladenie voliteľných závislostí.

Viď aj

Konfigurácia Weblate¶

Poznámka

Nasledujúce predpokladá, že Python prostredie používané Weblate je aktivované (vykonaním . ~/weblate-env/bin/activate). Ak nie, špecifikujte celú cestu k príkazu weblate ako ~/weblate-env/bin/weblate.

Skopírujte súbor ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py do ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Upravte hodnoty v novom súbore settings.py podľa svojich preferencií. Budete musieť poskytnúť aspoň prihlasovacie údaje k databáze a tajný kľúč Django, ale pre produkčné nastavenie budete chcieť viac zmien, pozrite Úprava konfigurácie.
Vytvorte databázu a jej štruktúru pre Weblate (príkladové nastavenia používajú PostgreSQL, skontrolujte Nastavenie databázy pre Weblate pre produkčne pripravené nastavenie):
```
weblate migrate
```
Viď aj

migrate
Vytvorte administrátorský účet admin, vygenerujte jeho heslo a skopírujte ho do schránky; nezabudnite si ho uložiť na neskoršie použitie:
```
weblate createadmin
```
Rada

Ak ste predtým prehliadli/stratili administrátorské heslo, môžete vygenerovať nové pomocou nasledujúceho príkazu:
```
weblate createadmin --update
```
Viď aj

createadmin
Zhromaždite statické súbory pre váš webový server (pozrite Spúšťanie servera a Obsluha statických súborov):
```
weblate collectstatic
```
Spustite pracovníkov Celery. Toto nie je potrebné pre vývojárske účely, ale inak sa dôrazne odporúča. Úlohy na pozadí pomocou Celery obsahuje viac informácií:
```
celery --app=weblate.utils worker --beat \
    --queues=celery,notify,memory,translate,backup \
    --prefetch-multiplier=1
```
Spustite vývojársky server (Spúšťanie servera podrobne popisuje produkčné nastavenie):
```
weblate runserver
```

Po inštalácii¶

Gratulujeme, váš server Weblate je teraz spustený a môžete ho začať používať.

Teraz môžete pristupovať k Weblate na http://localhost:8000/.
Prihláste sa s administrátorskými údajmi získanými počas inštalácie alebo zaregistrujte nových používateľov.
Teraz môžete spúšťať príkazy Weblate pomocou príkazu weblate, keď je aktívne Python prostredie Weblate, pozrite Manažérske príkazy.
Testovací server môžete zastaviť pomocou Ctrl+C.
Skontrolujte potenciálne problémy s vašou inštaláciou buď na URL /manage/performance/ (pozrite Výkonnostná správa) alebo pomocou weblate check --deploy, pozrite Produkčné nastavenie.

Pridanie prekladu¶

Otvorte administrátorské rozhranie (http://localhost:8000/create/project/) a vytvorte projekt, ktorý chcete prekladať. Viac podrobností nájdete v Konfigurácia projektu.

Všetko, čo tu musíte špecifikovať, je názov projektu a jeho webstránka.
Vytvorte komponent, ktorý je skutočným objektom na preklad - ukazuje na repozitár VCS a vyberá, ktoré súbory prekladať. Viac podrobností nájdete v Konfigurácia komponentu.

Dôležité polia tu sú: Názov komponentu, Repozitár zdrojového kódu a Maska súboru na nájdenie preložiteľných súborov. Weblate podporuje širokú škálu formátov vrátane GNU gettext PO (Portable Object), Zdroje reťazcov pre Android, Reťazce Apple iOS, Vlastnosti Java, Formát Stringsdict alebo Formát Fluent, viac podrobností nájdete v Formáty lokalizačných súborov.
Po dokončení vyššie uvedeného (môže to byť zdĺhavý proces v závislosti od veľkosti vášho VCS repozitára a počtu správ na preklad) môžete začať prekladať.