# Instalar no Debian e Ubuntu

## Requisitos de hardware

O Weblate deveria funcionar em qualquer “”hardware”” contemporâneo sem problemas. O seguinte é a configuração mínima necessária para executar o Weblate num único hospedeiro (Weblate, base de dados e servidor da Web):

* 3 GB de RAM
* 2 núcleos de CPU
* 1 GB de espaço de armazenamento

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

### Memória utilizada

Quanto mais memória, melhor - é usada para armazenamento em cache em todos os níveis (sistema de ficheiros, base de dados e Weblate). Para centenas de componentes de tradução, recomenda-se pelo menos 4 GB de RAM.

#### HINT
Para sistemas com menos memória do que o recomendado, [Configuração do Celery de processo único](https://docs.weblate.org/pt/latest/admin/install.md#minimal-celery) é recomendado.

### Uso da CPU

Muitos utilizadores simultâneos aumentam a quantidade de núcleos de CPU necessários.

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.

### Uso de armazenamento

O uso típico de armazenamento da base de dados é de cerca de 300 MB por 1 milhão de palavras alojadas.

O espaço de armazenamento necessário para repositórios clonados varia, mas o Weblate tenta manter o seu tamanho mínimo fazendo clones rasos.

### Desempenho de armazenamento

Operações de controlo de versão executam muitas consultas de metadados do sistema de ficheiros. Por isso, o sub diretório `vcs` em [`DATA_DIR`](https://docs.weblate.org/pt/latest/admin/config.md#std-setting-DATA_DIR) precisa de baixa latência de leitura; armazenamento com acesso de metadados lento pode fazer com que operações tais como **git status** levem muito tempo mesmo que a capacidade de processamento em massa seja bom. Mantenha [`CACHE_DIR`](https://docs.weblate.org/pt/latest/admin/config.md#std-setting-CACHE_DIR) em latência baixa local ou armazenamento temporário sempre que possível.

A implementação verifica a medida de latência de pesquisa de metadados para ambas localizações a avisa quando a latência mediana excede 10 milissegundos. Isto é uma medição aproximada num determinado momento afetado pela carga do sistema de ficheiros e do sistema. Execute **weblate check --deploy** novamente antes de alterar a configuração de armazenamento.

### Nós

Para sítios de pequeno e médio porte (milhões de palavras alojadas), todos os componentes do Weblate (consulte [Visão geral da arquitetura](https://docs.weblate.org/pt/latest/admin/install.md#architecture)) podem ser executados num único nó.

Quando atingir centenas de milhões de palavras alojadas, é recomendável ter um nó dedicado para a base de dados (consulte [Configuração da base de dados para o Weblate](https://docs.weblate.org/pt/latest/admin/install.md#database-setup)).

## Instalação

### Requisitos do sistema

Instale as dependências necessárias para criar módulos Python (consulte [Requisitos de software](https://docs.weblate.org/pt/latest/admin/install.md#requirements)):

```sh
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
```

Instale as dependências opcionais desejadas, dependendo dos recursos que pretende usar (veja [Dependências Python](https://docs.weblate.org/pt/latest/admin/install.md#python-deps)):

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

Opcionalmente, instale o software para executar o servidor de produção, veja [Executar o servidor](https://docs.weblate.org/pt/latest/admin/install.md#server), [Configuração da base de dados para o Weblate](https://docs.weblate.org/pt/latest/admin/install.md#database-setup), [Tarefas de fundo a usar o Celery](https://docs.weblate.org/pt/latest/admin/install.md#celery). Dependendo do tamanho da sua instalação, poderá executar esses componentes em servidores dedicados.

As instruções de instalação local:

```sh
# 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
```

### Gestor de pacotes uv

#### HINT
Estamos usando o gestor de pacotes uv para instalar o Weblate.

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

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

### Módulos do Python

#### HINT
Estamos a instalar o Weblate em um ambiente Python separado.

1. Crie o ambiente Python para o Weblate:
   ```sh
   uv venv ~/weblate-env
   ```
2. Ative o ambiente Python para o Weblate:
   ```sh
   . ~/weblate-env/bin/activate
   ```
3. Instale o Weblate incluindo todas as dependências opcionais:
   ```sh
   # Install Weblate with all optional dependencies
   uv pip install "weblate[all]"
   ```

   Por favor, consulte [Dependências Python](https://docs.weblate.org/pt/latest/admin/install.md#python-deps) para a otimização simples das dependências opcionais.

#### SEE ALSO
* [A usar ambientes Python](https://docs.astral.sh/uv/pip/environments/)
* [Solução de problemas via instalação pip](https://docs.weblate.org/pt/latest/admin/install.md#troubleshoot-pip-install)

### Configurando o Weblate

#### NOTE
O seguinte assume que o ambiente Python utilizado pela Weblate é ativado (executando `. ~/weblate-env/bin/activate`). Caso contrário, especificar o caminho completo para o comando **weblate** como `~/weblate-env/bin/weblate`.

1. Copie o ficheiro `~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py` para `~/weblate-env/lib/python3.9/site-packages/weblate/settings.py`.
2. Ajuste os valores no novo ficheiro `settings.py` de acordo com a sua preferência. Terá de fornecer pelo menos as credenciais da base de dados e o código secreto do Django, mas irá querer efetuar mais alterações para a configuração de produção, consulte [Ajustar a configuração](https://docs.weblate.org/pt/latest/admin/install.md#configuration).
3. Crie a base de dados e a sua estrutura para o Weblate (as definições de exemplo utilizam PostgreSQL, consulte [Configuração da base de dados para o Weblate](https://docs.weblate.org/pt/latest/admin/install.md#database-setup) para uma configuração pronta para produção):
   ```sh
   weblate migrate
   ```

   #### SEE ALSO
   [`migrate`](https://docs.weblate.org/pt/latest/admin/management.md#weblate-admin-migrate)
4. Crie uma conta de utilizador administrador `admin`, gere a sua palavra-passe e copie-a para a área de transferência; lembre-se de gravá-la para uso posterior:
   ```sh
   weblate createadmin
   ```

   #### HINT
   Se perdeu ou se esqueceu da sua palavra-passe de administrador anteriormente, pode gerar uma nova com o seguinte comando:
   ```sh
   weblate createadmin --update
   ```

   #### SEE ALSO
   [`createadmin`](https://docs.weblate.org/pt/latest/admin/management.md#weblate-admin-createadmin)
5. Colete os ficheiros estáticos para o seu servidor web (veja [Executar o servidor](https://docs.weblate.org/pt/latest/admin/install.md#server) e [Servir ficheiros estáticos](https://docs.weblate.org/pt/latest/admin/install.md#static-files)):
   ```sh
   weblate collectstatic
   ```
6. Inicie os workers do Celery. Isso não é necessário para fins de desenvolvimento, mas é altamente recomendado caso contrário. [Tarefas de fundo a usar o Celery](https://docs.weblate.org/pt/latest/admin/install.md#celery) tem mais informações:
   ```sh
   celery --app=weblate.utils worker --beat \
       --queues=celery,notify,memory,translate,backup \
       --prefetch-multiplier=1
   ```
7. Inicie o servidor de desenvolvimento ([Executar o servidor](https://docs.weblate.org/pt/latest/admin/install.md#server) detalha uma configuração de produção):
   ```sh
   weblate runserver
   ```

## Após a instalação

Parabéns, o seu servidor Weblate agora está a funcionar e pode começar a utilizá-lo.

* Agora pode aceder ao Weblate em `http://localhost:8000/`.
* Faça o login com as credenciais de administrador obtidas durante a instalação ou registe-se com novos utilizadores.
* Agora, pode executar comandos do Weblate, utilizando o comando **weblate** quando ambiente do Python Weblate está ativo, consulte [Comandos de gestão](https://docs.weblate.org/pt/latest/admin/management.md#manage).
* Pode parar o servidor de testes com `Ctrl`+`C`.
* Reveja os possíveis problemas com a sua instalação na URL `/manage/performance/` (ver [Relatório de desempenho](https://docs.weblate.org/pt/latest/admin/admin.md#manage-performance)) ou usando **weblate check --deploy**, ver [Configuração de produção](https://docs.weblate.org/pt/latest/admin/install.md#production).

### Adicionando tradução

1. Abra a interface de administração (`http://localhost:8000/create/project/`) e crie o projeto que deseja traduzir. Veja [Configuração de projeto](https://docs.weblate.org/pt/latest/admin/projects.md#project) para mais detalhes.

   Tudo que precisa especificar aqui é o nome do projeto e seu site.
2. Crie um componente que é o objeto real para tradução – ele aponta ao repositório VCS e seleciona quais ficheiros traduzir. Veja [Configuração de componente](https://docs.weblate.org/pt/latest/admin/projects.md#component) para mais detalhes.

   Os campos importantes aqui são: [Nome do componente](https://docs.weblate.org/pt/latest/admin/projects.md#component-name), [Repositório do código-fonte](https://docs.weblate.org/pt/latest/admin/projects.md#component-repo) e [Máscara de ficheiros](https://docs.weblate.org/pt/latest/admin/projects.md#component-filemask) para localizar ficheiros traduzíveis. Weblate tem suporte a uma ampla gama de formatos, incluindo [GNU gettext PO (Objeto Portátil)](https://docs.weblate.org/pt/latest/formats/gettext.md#gettext), [Recursos de cadeias de carateres para Android](https://docs.weblate.org/pt/latest/formats/android.md#aresource), [Cadeias de carateres para Apple iOS](https://docs.weblate.org/pt/latest/formats/apple.md#apple), [Propriedades Java](https://docs.weblate.org/pt/latest/formats/java.md#javaprop), [Formato stringsdict](https://docs.weblate.org/pt/latest/formats/stringsdict.md#stringsdict) ou [Formato Fluent](https://docs.weblate.org/pt/latest/formats/fluent.md#fluent), consulte [Formatos de ficheiro de localização](https://docs.weblate.org/pt/latest/formats.md#formats) para mais detalhes.
3. Depois que o acima for concluído (pode ser um processo demorado a depender do tamanho do seu repositório VCS e da quantidade de mensagens a serem traduzidas), pode começar a traduzir.
