Installing on SUSE and openSUSE

Requisitos de 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 webserver):

  • 2 GB de RAM

  • 2 núcleos de CPU

  • 1 GB de espaço de armazenamento

Quanto mais memória melhor – ele é usada para cache em todos os níveis (sistema de arquivos, banco de dados e Weblate).

Muitos usuários simultâneos aumentam a quantidade de núcleos de CPU necessários. Para centenas de componentes de tradução é recomendado pelo menos 4 GB de RAM.

O uso típico de armazenamento de banco de dados é de cerca de 300 MB por 1 milhão de palavras hospedadas. O espaço de armazenamento necessário para repositórios clonados varia, mas o Weblate tenta manter seu tamanho mínimo fazendo clones rasos.


Os requisitos reais para a sua instalação do Weblate variam fortemente com base no tamanho das traduções gerenciadas nele.


System requirements

Install the dependencies needed to build the Python modules (see Requisitos de software):

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel libyaml-devel \
   cairo-devel typelib-1_0-Pango-1_0 gobject-introspection-devel libacl-devel \
   python3-pip python3-virtualenv python3-devel git

Install wanted optional dependencies depending on features you intend to use (see Dependências opcionais):

zypper install tesseract-ocr tesseract-devel leptonica-devel

Optionally install software for running production server, see Executando servidor, Configuração de banco de dados para o Weblate, Tarefas de fundo usando Celery. Depending on size of your installation you might want to run these components on dedicated servers.

The local installation instructions:

# 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: Redis
zypper install redis-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

Python modules


We’re using virtualenv to install Weblate in a separate environment from your system. If you are not familiar with it, check virtualenv User Guide.

  1. Create the virtualenv for Weblate:

    virtualenv --python=python3 ~/weblate-env
  2. Activate the virtualenv for Weblate:

    . ~/weblate-env/bin/activate
  3. Install Weblate including all dependencies:

    pip install Weblate
  4. Install database driver:

    pip install psycopg2-binary
  5. Install wanted optional dependencies depending on features you intend to use (some might require additional system libraries, check Dependências opcionais):

    pip install ruamel.yaml aeidon boto3 zeep chardet tesserocr

Configuring Weblate


Following steps assume virtualenv used by Weblate is active (what can be done by . ~/weblate-env/bin/activate). In case this is not true, you will have to specify full path to weblate command as ~/weblate-env/bin/weblate.

  1. Copy the file ~/weblate-env/lib/python3.7/site-packages/weblate/ to ~/weblate-env/lib/python3.7/site-packages/weblate/

  2. Adjust the values in the new file to your liking. You can stick with shipped example for testing purposes, but you will want changes for production setup, see Ajustando a configuração.

  3. Create the database and its structure for Weblate (the example settings use PostgreSQL, check Configuração de banco de dados para o Weblate for production ready setup):

    weblate migrate
  4. Create the administrator user account and copy the password it outputs to the clipboard, and also save it for later use:

    weblate createadmin
  5. Collect static files for web server (see Executando servidor and Servindo arquivos estáticos):

    weblate collectstatic
  6. Compress JavaScript and CSS files (optional, see Comprimindo os ativos do cliente):

    weblate compress
  7. Start Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. See Tarefas de fundo usando Celery for more info:

    ~/weblate-env/lib/python3.7/site-packages/weblate/examples/celery start
  8. Start the development server (see Executando servidor for production setup):

    weblate runserver

After installation

Congratulations, your Weblate server is now running and you can start using it.

  • You can now access Weblate on http://localhost:8000/.

  • Login with admin credentials obtained during installation or register with new users.

  • You can now run Weblate commands using weblate command when Weblate virtualenv is active, see Management commands.

  • You can stop the test server with Ctrl+C.

  • Review potential issues with your installation either on /manage/performance/ URL or using weblate check --deploy, see Configuração de produção.

Adding translation

  1. Open the admin interface (http://localhost:8000/create/project/) and create the project you want to translate. See Project configuration for more details.

    All you need to specify here is the project name and its website.

  2. Create a component which is the real object for translation - it points to the VCS repository, and selects which files to translate. See Component configuration for more details.

    The important fields here are: Component name, VCS repository address and mask for finding translatable files. Weblate supports a wide range of formats including gettext PO files, Android resource strings, iOS string properties, Java properties or Qt Linguist files, see Formatos de arquivos suportados for more details.

  3. Once the above is completed (it can be lengthy process depending on the size of your VCS repository, and number of messages to translate), you can start translating.