Installation unter Debian und Ubuntu¶

Hardwareanforderungen¶

Weblate sollte auf jeder modernen Hardware problemlos laufen. Nachfolgend finden Sie die minimale Konfiguration, die erforderlich ist, um Weblate auf einem einzelnen Host zu betreiben (Weblate, Datenbank und Webserver):

3 GB Arbeitsspeicher
2 CPU-Kerne
1 GB Speicherplatz

Bemerkung

Die tatsächlichen Anforderungen an Ihre Weblate-Installation hängen stark von der Größe der darin verwalteten Übersetzungen ab.

RAM-Auslastung¶

Je mehr Arbeitsspeicher, desto besser – er wird für das Caching auf allen Ebenen (Dateisystem, Datenbank und Weblate) verwendet. Für Hunderte von Übersetzungskomponenten werden mindestens 4 GB RAM empfohlen.

Hinweis

Für Systeme mit weniger Arbeitsspeicher, wird Celery-Einzelprozess einrichten empfohlen.

CPU-Auslastung¶

Viele gleichzeitige Benutzer erhöhen die Anzahl der benötigten CPU-Kerne.

Speichernutzung¶

Der typische Speicherbedarf der Datenbank liegt bei 300 MB pro 1 Million gehosteter Wörter.

Der benötigte Speicherplatz für geklonte Repositorys variiert, aber Weblate versucht, die Größe der Repositorys durch flache Klone gering zu halten.

Knoten¶

Für kleine und mittelgroße Plattformen (Millionen von gehosteten Wörtern) können alle Komponenten von Weblate (siehe Architekturübersicht) auf einem einzigen Knoten ausgeführt werden.

Wenn die Anzahl der gehosteten Wörter auf Hunderte Millionen anwächst, empfiehlt sich ein dedizierter Knoten für die Datenbank (siehe Datenbankeinrichtung für Weblate).

Installation¶

Systemvoraussetzungen¶

Installieren Sie die Abhängigkeiten, die für die Erstellung der Python-Module erforderlich sind (siehe Softwareanforderungen):

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 gir1.2-rsvg-2.0 libgirepository-2.0-dev \
   libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev git

Hinweis

Ältere Distributionen haben kein libgirepository-2.0-dev, verwenden Sie stattdessen libgirepository1.0-dev. Siehe auch Fehlerbehebung bei pip install.

Installieren Sie die gewünschten optionalen Abhängigkeiten abhängig von den Funktionen, die Sie verwenden möchten (siehe Python-Abhängigkeiten):

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

Installieren Sie optional Software für den Betrieb des Produktionsservers, siehe Laufender Server, Datenbankeinrichtung für Weblate, Hintergrundaufgaben mit Celery. Je nach Größe Ihrer Installation sollten Sie diese Komponenten auf dedizierten Servern laufen lassen.

Lokale Installationsanweisungen:

# 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 for the msgmerge add-on
apt install -y gettext

uv-Paketmanager¶

Hinweis

Wir benutzen den uv-Paketmanager, um Weblate zu installieren.

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

Siehe auch

uv installieren

Python-Module¶

Hinweis

Wir installieren Weblate in einer separaten Python-Einsatzumgebung.

Die Python-Einsatzumgebung für Weblate erstellen:
```
uv venv ~/weblate-env
```
Die Python-Einsatzumgebung für Weblate aktivieren:
```
. ~/weblate-env/bin/activate
```
Weblate einschließlich aller optionalen Abhängigkeiten installieren:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Bitte die Python-Abhängigkeiten für die Feinabstimmung der optionalen Abhängigkeiten überprüfen.

Siehe auch

Weblate konfigurieren¶

Bemerkung

Im Folgenden wird davon ausgegangen, dass die von Weblate verwendete Python-Einsatzumgebung aktiviert ist (durch Ausführung von . ~/weblate-env/bin/activate). Falls nicht, geben Sie den vollständigen Pfad zum Befehl weblate als ~/weblate-env/bin/weblate an.

Die Datei ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py nach ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py kopieren.
Die Werte in der neuen Datei settings.py nach eigenen Wünschen anpassen. Es müssen zumindest die Datenbank-Zugangsdaten und der geheime Django-Schlüssel angeben werden, es werden jedoch mehr Änderungen für die Produktionseinrichtung benötigt, siehe Konfiguration anpassen.
Die Datenbank und ihre Struktur für Weblate erstellen (die Beispieleinstellungen verwenden PostgreSQL, siehe Datenbankeinrichtung für Weblate für eine produktionsreife Einrichtung):
```
weblate migrate
```
Siehe auch

migrate
Ein Administrator-Benutzerkonto admin erstellen, dessen Passwort generieren und es in die Zwischenablage kopieren; denken Sie daran, es zur späteren Verwendung zu speichern:
```
weblate createadmin
```
Hinweis

Wenn Sie das Administratorpasswort vergessen oder verloren haben, können Sie mit dem folgenden Befehl ein neues Passwort erstellen:
```
weblate createadmin --update
```
Siehe auch

createadmin
Die statischen Dateien für den Webserver sammeln (siehe Laufender Server und Statische Dateien bereitstellen):
```
weblate collectstatic
```
Die JavaScript- und CSS-Dateien komprimieren (optional, siehe Client-Assets komprimieren):
```
weblate compress
```
Die Celery-Worker starten. Dies ist für Entwicklungszwecke nicht notwendig, wird aber ansonsten dringend empfohlen. Hintergrundaufgaben mit Celery hat mehr Informationen:
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
Den Entwicklungsserver starten (Laufender Server beschreibt eine Produktionseinrichtung):
```
weblate runserver
```

Nach der Installation¶

Herzlichen Glückwunsch, Ihr Weblate-Server läuft jetzt und Sie können ihn nutzen.

Sie können jetzt auf Weblate unter http://localhost:8000/ zugreifen.
Melden Sie sich mit den bei der Installation erhaltenen Administrator-Zugangsdaten an oder registrieren Sie sich mit neuen Benutzern.
Sie können jetzt Weblate-Befehle mit dem Befehl weblate ausführen, wenn die Weblate-Python-Einsatzumgebung aktiv ist, siehe Verwaltungsbefehle.
Sie können den Testserver mit Strg+C anhalten.
Überprüfen Sie mögliche Probleme mit Ihrer Installation entweder unter der URL /manage/performance/ (siehe Leistungsbericht) oder mit weblate check --deploy, siehe Produktionseinrichtung.

Übersetzung hinzufügen¶

Die Adminoberfläche öffnen (http://localhost:8000/create/project/) und ein Projekt erstellen, das übersetzt werden soll. Siehe Projektkonfiguration für weitere Details.

Es muss hier nur der Name des Projekts und dessen Website angegeben werden.
Eine Komponente erstellen, die das eigentliche Objekt für die Übersetzung ist – sie verweist auf das VCS-Repository und wählt die zu übersetzenden Dateien aus. Siehe Komponentenkonfiguration für weitere Details.

Die wichtigen Felder hier, um übersetzbare Dateien zu finden, sind: Komponentenname, Quellcode-Repository und Dateimaske. Weblate unterstützt eine Vielzahl von Formaten, darunter GNU gettext PO (Portable Object), Android-Zeichenketten-Ressourcen, Apple-iOS-Zeichenketten, Java Properties, Stringsdict-Format oder Fluent-Format, siehe Lokalisierungsdateiformate für weitere Details.
Sobald die Schritte oben abgeschlossen sind (je nach Größe Ihres VCS-Repositorys und der Anzahl der zu übersetzenden Nachrichten kann dies ein langwieriger Prozess sein), kann mit dem Übersetzen begonnen werden.