# Instalarea pe SUSE și openSUSE

## Cerințe hardware

Weblate should run on any contemporary hardware without problems, the following is
the minimal configuration required to run Weblate on a single host (Weblate, database
and web server):

* 3 GB of RAM
* 2 nuclee CPU
* 1 GB de spațiu de stocare

#### NOTE
Cerințele reale pentru instalarea Weblate variază foarte mult în funcție de dimensiunea traducerilor gestionate în cadrul acesteia.

### Memory usage

The more memory the better - it is used for caching on all
levels (file system, database and Weblate).
For hundreds of translation components, at least 4 GB of RAM is
recommended.

#### HINT
For systems with less memory than recommended, [Single-process Celery setup](https://docs.weblate.org/ro/latest/admin/install.md#minimal-celery) is recommended.

### CPU usage

Many concurrent users increase the amount of needed CPU cores.

Weblate 2026.8 introduced NumPy as a required dependency. On x86-64 systems,
the optimized NumPy build bundled in the Docker image requires an x86-64-v2
compatible CPU. Without the required CPU features, NumPy fails to load and
Weblate cannot start.

Before upgrading, check for the required SSE4.2 CPU feature on the Linux system
running Docker:

```sh
grep sse4_2 /proc/cpuinfo
```

Empty output indicates that a required CPU feature is unavailable. This is a
preliminary check; finding SSE4.2 does not verify all x86-64-v2 CPU features.

If Docker runs in a virtual machine, run the check inside the guest. Virtual
machines can hide CPU features supported by the host. Configure the virtual
machine to expose the required host CPU features, then reboot the guest. If
the physical CPU lacks the required features, upgrade the hardware.

### Storage usage

The typical database storage usage is around 300 MB per 1 million hosted words.

Storage space needed for cloned repositories varies, but Weblate tries to keep
their size minimal by doing shallow clones.

### Storage performance

Version control operations perform many filesystem metadata lookups. The
`vcs` subdirectory in [`DATA_DIR`](https://docs.weblate.org/ro/latest/admin/config.md#std-setting-DATA_DIR) therefore needs low read
latency; storage with slow metadata access can make operations such as
**git status** take a long time even when its bulk throughput is good.
Keep [`CACHE_DIR`](https://docs.weblate.org/ro/latest/admin/config.md#std-setting-CACHE_DIR) on low-latency local or temporary storage when
possible.

The deployment checks measure metadata lookup latency for both locations and
warn when the median latency exceeds 10 milliseconds. This is an approximate
point-in-time measurement affected by filesystem and system load. Rerun
**weblate check --deploy** before changing the storage configuration.

### Nodes

For small and medium-sized sites (millions of hosted words), all Weblate components (see
[Architecture overview](https://docs.weblate.org/ro/latest/admin/install.md#architecture)) can be run on a single node.

When you grow to hundreds of millions of hosted words, it is recommended to
have a dedicated node for database (see [Configurarea bazei de date pentru Weblate](https://docs.weblate.org/ro/latest/admin/install.md#database-setup)).

## Instalare

### Cerințe de sistem

Instalați dependențele necesare pentru a construi modulele Python (consultați [Cerințe software](https://docs.weblate.org/ro/latest/admin/install.md#requirements)):

```sh
zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel libacl-devel liblz4-devel libzstd-devel libxxhash-devel \
   python3-devel git
```

Install wanted optional dependencies depending on features you intend to use (see [Dependențe Python](https://docs.weblate.org/ro/latest/admin/install.md#python-deps)):

```sh
zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel
```

Instalarea opțională a software-ului pentru rularea serverului de producție, a se vedea [Rularea serverului](https://docs.weblate.org/ro/latest/admin/install.md#server), [Configurarea bazei de date pentru Weblate](https://docs.weblate.org/ro/latest/admin/install.md#database-setup), [Sarcini de fundal folosind Celery](https://docs.weblate.org/ro/latest/admin/install.md#celery). În funcție de mărimea instalației tale, este posibil să dorești să rulezi aceste componente pe servere dedicate.

Instrucțiunile de instalare locală:

```sh
# Web server option 1: NGINX and uWSGI
zypper install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Valkey
zypper install valkey-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

# Gettext tools for gettext POT/PO update add-ons
zypper install gettext
```

### uv package manager

#### HINT
We’re using uv package manager to install Weblate.

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

#### SEE ALSO
[Installing uv](https://docs.astral.sh/uv/getting-started/installation/)

### Module Python

#### HINT
We’re installing Weblate in a separate Python environment.

1. Create the Python environment for Weblate:
   ```sh
   uv venv ~/weblate-env
   ```
2. Activate the Python environment for Weblate:
   ```sh
   . ~/weblate-env/bin/activate
   ```
3. Instalați Weblate, inclusiv toate dependențele opționale:
   ```sh
   # Install Weblate with all optional dependencies
   uv pip install "weblate[all]"
   ```

   Please check [Dependențe Python](https://docs.weblate.org/ro/latest/admin/install.md#python-deps) for fine-tuning of optional dependencies.

#### SEE ALSO
* [Using Python environments](https://docs.astral.sh/uv/pip/environments/)
* [Troubleshooting pip install](https://docs.weblate.org/ro/latest/admin/install.md#troubleshoot-pip-install)

### Configurarea Weblate

#### NOTE
The following assumes the Python environment used by Weblate is activated
(by executing `. ~/weblate-env/bin/activate`). If not, specify the full path
to the **weblate** command as `~/weblate-env/bin/weblate`.

1. Copiați fișierul `~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py` în `~/weblate-env/lib/python3.9/site-packages/weblate/settings.py`.
2. Ajustați valorile din noul fișier `settings.py` după bunul plac. Va trebui să furnizați cel puțin credențialele bazei de date și cheia secretă Django, dar veți dori mai multe modificări pentru configurarea de producție, consultați [Ajustarea configurației](https://docs.weblate.org/ro/latest/admin/install.md#configuration).
3. Creați baza de date și structura acesteia pentru Weblate (setările de exemplu utilizează PostgreSQL, verificați [Configurarea bazei de date pentru Weblate](https://docs.weblate.org/ro/latest/admin/install.md#database-setup) pentru o configurație pregătită pentru producție):
   ```sh
   weblate migrate
   ```

   #### SEE ALSO
   [`migrate`](https://docs.weblate.org/ro/latest/admin/management.md#weblate-admin-migrate)
4. Create an administrator user account `admin`, generate its password, and copy it
   to the clipboard; remember to save it for later use:
   ```sh
   weblate createadmin
   ```

   #### HINT
   If you previously missed/lost the admin password, you can generate a new one with the following command:
   ```sh
   weblate createadmin --update
   ```

   #### SEE ALSO
   [`createadmin`](https://docs.weblate.org/ro/latest/admin/management.md#weblate-admin-createadmin)
5. Colectează fișierele statice pentru serverul tău web (a se vedea [Rularea serverului](https://docs.weblate.org/ro/latest/admin/install.md#server) și [Servirea fișierelor statice](https://docs.weblate.org/ro/latest/admin/install.md#static-files)):
   ```sh
   weblate collectstatic
   ```
6. Începeți lucrurile cu Celery. Acest lucru nu este necesar în scopuri de dezvoltare, dar este recomandat cu tărie în caz contrar. Pentru mai multe informații, consultați [Sarcini de fundal folosind Celery](https://docs.weblate.org/ro/latest/admin/install.md#celery):
   ```sh
   celery --app=weblate.utils worker --beat \
       --queues=celery,notify,memory,translate,backup \
       --prefetch-multiplier=1
   ```
7. Porniți serverul de dezvoltare ( [Rularea serverului](https://docs.weblate.org/ro/latest/admin/install.md#server) configurația de producție):
   ```sh
   weblate runserver
   ```

## După instalare

Felicitări, serverul Weblate este acum în funcțiune și puteți începe să îl utilizați.

* Acum puteți accesa Weblate pe `http://localhost:8000/`.
* Conectați-vă cu acreditările de administrator obținute în timpul instalării sau înregistrați-vă cu utilizatori noi.
* You can now run Weblate commands using **weblate** command when
  Weblate Python environment is active, see [Comenzi de gestionare](https://docs.weblate.org/ro/latest/admin/management.md#manage).
* You can stop the test server with `Ctrl`+`C`.
* Review potential issues with your installation either on `/manage/performance/` URL (see [Raport de performanță](https://docs.weblate.org/ro/latest/admin/admin.md#manage-performance)) or using **weblate check --deploy**, see [Configurarea producției](https://docs.weblate.org/ro/latest/admin/install.md#production).

### Adăugarea traducerii

1. Deschideți interfața de administrare (`http://localhost:8000/create/project/`) și creați proiectul pe care doriți să-l traduceți. Consultați [Configurația proiectului](https://docs.weblate.org/ro/latest/admin/projects.md#project) pentru mai multe detalii.

   Tot ce trebuie să specificați aici este numele proiectului și site-ul acestuia.
2. Creați o componentă care este obiectul real al traducerii - aceasta indică depozitul VCS și selectează fișierele care trebuie traduse. Pentru mai multe detalii, consultați [Configurația componentei](https://docs.weblate.org/ro/latest/admin/projects.md#component).

   Câmpurile importante aici sunt: [Nume componentă](https://docs.weblate.org/ro/latest/admin/projects.md#component-name), [Depozitar cod sursă](https://docs.weblate.org/ro/latest/admin/projects.md#component-repo) și [Mască de fișier](https://docs.weblate.org/ro/latest/admin/projects.md#component-filemask) pentru găsirea fișierelor traductibile. Weblate acceptă o gamă largă de formate, inclusiv [GNU gettext PO (Portable Object)](https://docs.weblate.org/ro/latest/formats/gettext.md#gettext), [Resurse de șiruri Android](https://docs.weblate.org/ro/latest/formats/android.md#aresource), [Șiruri Apple iOS](https://docs.weblate.org/ro/latest/formats/apple.md#apple), [Proprietăți Java](https://docs.weblate.org/ro/latest/formats/java.md#javaprop), [Format Stringsdict](https://docs.weblate.org/ro/latest/formats/stringsdict.md#stringsdict) sau [Format fluent](https://docs.weblate.org/ro/latest/formats/fluent.md#fluent), consultați [Localization file formats](https://docs.weblate.org/ro/latest/formats.md#formats) pentru mai multe detalii.
3. După ce ați finalizat cele de mai sus (poate fi un proces de lungă durată, în funcție de dimensiunea depozitului VCS și de numărul de mesaje de tradus), puteți începe traducerea.
