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 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.
Arquivo¶
Edição Community:
Servidor noturno <https://nightly.odoo.com>
Edição Enterprise:
Git¶
Nota
É necessário ter o Git instalado, e é recomendável ter um conhecimento básico dos comandos do Git para prosseguir.
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.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Nota
O repositório git do Enterprise não contém o código-fonte completo do Odoo. Ele é apenas uma coleção de complementos extras. O código principal do servidor está na edição Community. Executar a versão Enterprise significa executar o servidor a partir da versão Community com a opção addons-path definida para a pasta com a edição Enterprise. É necessário clonar os repositórios Community e Enterprise para ter uma instalação funcional do Odoo Enterprise.
Preparação¶
Python¶
O Odoo requer Python 3.10 ou posterior para ser executado.
Alterado na versão 17: Requisito mínimo atualizado de Python 3.7 para Python 3.10.
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.
Nota
Se já houver Python 3 instalado, certifique-se de que a versão seja 3.10 ou superior, pois as versões anteriores não são compatíveis com o Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verifique se o pip também está instalado para essa versão.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
O Odoo usa o PostgreSQL como seu sistema de gerenciamento da base de dados.
Use um gerenciador de pacotes para fazer download e instalar o PostgreSQL (versões compatíveis: 12.0 ou superior). Isso pode ser feito executando o seguinte:
$ sudo apt install postgresql postgresql-client
Faça o download do PostgreSQL <https://www.postgresql.org/download/windows>`_ (versões compatíveis: 12.0 ou superior) e instale-o.
Use Postgres.app para fazer download e instalar o PostgreSQL (versão compatível: 12.0 ou superior).
Dica
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.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
Como o usuário do PostgreSQL tem o mesmo nome de login do Unix, é possível se conectar à base de dados sem uma senha.
Adicione o diretório
bindo PostgreSQL (por padrão:C:\Program Files\PostgreSQL\1\bin) aoPATH.Crie um usuário postgres com uma senha usando o gui de administração do pg:
Abra o pgAdmin.
Clique duas vezes no servidor para criar uma conexão.
Selecione .
Digite o nome de usuário no campo Nome da função (por exemplo,
odoo).Abra a aba Definição, digite uma senha (por exemplo,
odoo) e clique em Salvar.Abra a aba Privilégios e altere Pode fazer login? para
Sime Criar base de dados? paraSim.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
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.
No Debian/Ubuntu, os seguintes comandos devem instalar os pacotes necessários:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
O script setup/debinstall.sh analisará o arquivo debian/control e instalará os pacotes encontrados.
Aviso
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.
Nota
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.
Dica
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.
Dica
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.
Dica
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
Nota
Para idiomas que usam uma interface da direita para a esquerda (como árabe ou hebraico), o pacote rtlcss é necessário.
Faça download e instale nodejs e npm com um gerenciador de pacotes.
Instalar o
rtlcss:$ sudo npm install -g rtlcss
Faça download e instale o nodejs.
Instalar o
rtlcss:C:\> npm install -g rtlcssEdite a variável
PATHdo ambiente do sistema para adicionar a pasta onde ortlcss.cmdestá localizado (normalmente:C:\Users\<user>\AppData\Roaming\npm\).
Aviso
O wkhtmltopdf não é instalado por pip e deve ser instalado manualmente na versão 0.12.6 para que ofereça suporte a cabeçalhos e rodapés. Consulte o wkhtmltopdf wiki para obter mais detalhes sobre as várias versões.
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 ou um arquivo de configuração.
Dica
Para a edição Enterprise, adicione o caminho para os add-ons enterprise ao argumento addons-path. Observe que ele deve vir antes dos outros caminhos em addons-path para que os add-ons sejam carregados corretamente.
As configurações comuns necessárias são:
Usuário e senha do PostgreSQL.
Personalize os caminhos de complemento além dos padrões para carregar módulos personalizados.
Uma maneira típica de executar o servidor seria:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Em que CommunityPath é o caminho da instalação do Odoo Community e mydb é o nome da base de dados PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
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.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
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.
Dica
Veja também