Pular para o conteúdo
Documentação do usuário

Instalação da fonte

A 'instalação' de fonte não se trata de instalar o Odoo, mas de executá-lo diretamente da fonte.

Usar a fonte do Odoo pode ser mais conveniente para desenvolvedores de módulos, pois é mais fácil de acessar do que pelo uso de instaladores em pacote.

Isso torna a inicialização e a interrupção do Odoo mais flexíveis e explícitas do que os serviços configurados pelos instaladores em pacote. Além disso, permite substituir configurações usando parâmetros de linha de comando <reference/cmdline> sem a necessidade de editar um arquivo de configuração.

Por fim, oferece também maior controle sobre a configuração do sistema e permite manter (e executar) com mais facilidade várias versões do Odoo lado a lado.

Obter as fontes

Há duas maneiras de obter o código-fonte do Odoo: como um arquivo ZIP ou pelo Git.

Arquivar

Edição Community:

Edição Enterprise:

Git

Para clonar um repositório Git, escolha entre clonar com HTTPS ou SSH. Na maioria dos casos, a melhor opção é o HTTPS. No entanto, escolha SSH para contribuir com o código-fonte do Odoo ou ao seguir o tutorial de Primeiros passos para desenvolvedores.

Preparação

Python

O Odoo requer Python 3.10 ou posterior para ser executado.

Use um gerenciador de pacotes para fazer download e instalar o Python 3, se necessário.

Faça o download da versão mais recente do Python 3 <https://www.python.org/downloads/windows/>`_ e instale-o.

Durante a instalação, marque Adicionar Python 3 ao PATH, clique em Personalizar instalação e verifique se pip está marcado.

Use um gerenciador de pacotes (Homebrew, MacPorts) para fazer download e instalar o Python 3, se necessário.

Verifique se o pip também está instalado para essa versão.

PostgreSQL

O Odoo usa o PostgreSQL como seu sistema de gerenciamento da base de dados.

Use um gerenciador de pacotes para baixar e instalar o PostgreSQL (versões suportadas: 13.0 ou superior). Isso pode ser feito executando o seguinte:

$ sudo apt install postgresql postgresql-client

Baixe o PostgreSQL (versões suportadas: 13.0 ou superior) e instale-o.

Use Postgres.app para baixar e instalar o PostgreSQL (versão suportada: 13.0 ou superior).

Para disponibilizar as ferramentas de linha de comando incluídas no Postgres.app, certifique-se de configurar a variável $PATH seguindo as instruções das ferramentas de CLI do Postgres.app <https://postgresapp.com/documentation/cli-tools.html>`_.

Por padrão, o único usuário é o postgres. Como o Odoo proíbe a conexão como postgres, crie um novo usuário PostgreSQL.

Como o usuário do PostgreSQL tem o mesmo nome de login do Unix, é possível se conectar à base de dados sem uma senha.

Como o usuário do PostgreSQL tem o mesmo nome de login do Unix, é possível se conectar à base de dados sem uma senha.

Dependências

O uso de pacotes de distribuição é a maneira preferida de instalar dependências. Como alternativa, instale as dependências do Python com pip.

Debian/Ubuntu

No Debian/Ubuntu, os seguintes comandos devem instalar os pacotes necessários:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

The setup/debinstall.sh script will parse the debian/control file and install the found packages.

O uso dee pip pode levar a problemas de segurança e dependências quebradas; só use isso se tiver certeza de suas ações.

Como alguns dos pacotes Python precisam de uma etapa de compilação, é necessário que bibliotecas do sistema sejam instaladas.

No Debian/Ubuntu, o comando a seguir deve instalar essas bibliotecas necessárias:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

As dependências do Odoo estão listadas no arquivo requirements.txt localizado na raiz do diretório Odoo Community.

Os pacotes Python em requirements.txt são baseados em suas versões correspondentes stable/LTS Debian/Ubuntu no momento do lançamento do Odoo. Por exemplo, para o Odoo 15.0, a versão do pacote python3-babel é 2.8.0 no Debian Bullseye e 2.6.0 no Ubuntu Focal. A versão mais baixa é então escolhida no requirements.txt.

Pode ser preferível não misturar pacotes de módulos Python entre diferentes instâncias do Odoo ou com o sistema. No entanto, é possível usar o virtualenv para criar ambientes Python isolados.

Navegue até o caminho da instalação do Odoo Community (CommunityPath) e execute pip no arquivo de requisitos para instalar os requisitos para o usuário atual.

$ cd /CommunityPath
$ pip install -r requirements.txt

Antes de instalar as dependências, faça download e instale as Ferramentas de compilação para Visual Studio. Selecione Ferramentas de compilação C++ na aba Workloads e instale-as quando solicitado.

As dependências do Odoo estão listadas no arquivo requirements.txt localizado na raiz do diretório Odoo Community.

Pode ser preferível não misturar pacotes de módulos Python entre diferentes instâncias do Odoo ou com o sistema. No entanto, é possível usar o virtualenv para criar ambientes Python isolados.

Navegue até o caminho da instalação do Odoo Community (CommunityPath) e execute pip no arquivo de requisitos em um terminal com privilégios de administrador:

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

As dependências do Odoo estão listadas no arquivo requirements.txt localizado na raiz do diretório Odoo Community.

Pode ser preferível não misturar pacotes de módulos Python entre diferentes instâncias do Odoo ou com o sistema. No entanto, é possível usar o virtualenv para criar ambientes Python isolados.

Navegue até o caminho da instalação do Odoo Community (CommunityPath) e execute pip no arquivo de requisitos:

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

As dependências que não são do Python devem ser instaladas com um gerenciador de pacotes (Homebrew, MacPorts).

  1. Download and install the Command Line Tools:

    $ xcode-select --install
  2. Use the package manager to install non-Python dependencies.

Executar o Odoo

Depois que todas as dependências estiverem configuradas, o Odoo poderá ser iniciado executando o odoo-bin, a interface de linha de comando do servidor. Ela está localizada na raiz do diretório Odoo Community.

Para configurar o servidor, especifique argumentos de linha de comando <reference/cmdline/server> ou um arquivo de configuração <reference/cmdline/config>.

As configurações comuns necessárias são:

  • PostgreSQL user and password.

  • Custom addon paths beyond the defaults to load custom modules.

Uma maneira típica de executar o servidor seria:

Em que CommunityPath é o caminho da instalação do Odoo Community e mydb é o nome da base de dados PostgreSQL.

Em que CommunityPath é o caminho da instalação do Odoo Community, dbuser é o login do PostgreSQL, dbpassword é a senha do PostgreSQL e mydb é o nome da base de dados PostgreSQL.

Em que CommunityPath é o caminho da instalação do Odoo Community e mydb é o nome da base de dados PostgreSQL.

Depois que o servidor for iniciado (o registro INFO odoo.modules.loading: Módulos carregados. é impresso), abra o site http://localhost:8069 em um navegador da Web e faça login na base de dados do Odoo com a conta de administrador da base: use admin como e-mail e, novamente, admin como senha.