Instalación con el código fuente¶
La «instalación» desde el código fuente no se trata de instalar Odoo, sino de ejecutarlo directo desde el mismo código.
Es posible que para los desarrolladores de módulos sea más conveniente usar el código fuente de Odoo, ya que es más accesible que usar los instaladores de paquetes.
También hace que iniciar y detener Odoo sea más flexible y explícito que con los servicios configurados por las instalaciones en paquete. También permite sobrescribir los ajustes mediante parámetros de la línea de comandos sin tener que editar el archivo de configuración.
Por último, permite gestionar mejor la configuración del sistema y mantener (y ejecutar) varias versiones de Odoo al mismo tiempo sin complicaciones.
Obtención del código fuente¶
Hay dos formas de obtener el código fuente de Odoo: como archivo ZIP o mediante Git.
Archivo¶
Edición Community:
Edición Enterprise:
Git¶
Nota
Es necesario que tengas Git instalado y te recomendamos contar con conocimientos básicos de los comandos de Git para continuar.
Para clonar un repositorio de Git, elige si hacerlo con HTTPS o con SSH. La mejor opción es HTTPS en la mayoría de los casos, pero debes usar SSH si quieres contribuir al código fuente de Odoo o cuando utilizas el tutorial para desarrolladores.
$ 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
El repositorio Git de Enterprise no contiene todo el código fuente de Odoo, solo incluye algunos complementos y módulos adicionales. El código principal del servidor está en la edición Community. Ejecutar la versión Enterprise significa ejecutar el servidor desde la edición Community con la opción addons-path
dirigida a la carpeta de la edición Enterprise. Para tener una instalación funcional de la edición Enterprise de Odoo debes clonar ambos repositorios, Community y Enterprise.
Preparación¶
Python¶
Odoo necesita Python 3.10 o una versión posterior para funcionar.
Distinto en la versión 17: El requisito mínimo cambió de Python 3.7 a Python 3.10.
Usa un gestor de paquetes para descargar e instalar Python 3 si es necesario.
Descarga la versión más reciente de Python 3 e instálala.
Durante la instalación, selecciona Agregar Python 3 a la RUTA, después haz clic en Personalizar la instalación y asegúrate de que pip esté seleccionado.
Nota
Si ya tienes Python 3 instalado, asegúrate de que sea la versión 3.10 o superior, ya que las versiones anteriores no son compatibles con Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verifica que pip también esté instalado para esta versión.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo utiliza PostgreSQL como sistema de gestión de bases de datos.
Usa un gestor de paquetes para descargar e instalar PostgreSQL (versiones compatibles: 12.0 o superiores). Para ello, ejecuta el siguiente comando:
$ sudo apt install postgresql postgresql-client
Descarga PostgreSQL (versiones compatibles: 12.0 o superiores) e instálalo.
Usa Postgres.app para descargar e instalar PostgreSQL (versión compatible: 12.0 o superiores).
Truco
Para que las herramientas de la línea de comandos incluidas en Postgres.app estén disponibles, asegúrate de configurar la variable $PATH
con las instrucciones de las herramientas CLI de Postgres.app.
De forma predeterminada, el único usuario es postgres
. Odoo no permite conectarse con postgres
, así que debes crear un nuevo usuario de PostgreSQL.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
El usuario de PostgreSQL tiene el mismo nombre que el inicio de sesión de Unix, así que es posible conectarse a la base de datos sin contraseña.
Agrega el directorio
bin
de PostgreSQL (de manera predeterminada:C:\Program Files\PostgreSQL\<version>\bin
) aPATH
.Crea un usuario de PostgreSQL con contraseña mediante la interfaz gráfica de pgAdmin:
Abre pgAdmin.
Haz doble clic en el servidor para crear una conexión.
Selecciona
.Ingresa el nombre de usuario en el campo Nombre de la función (por ejemplo,
odoo
).Abre la pestaña Definición, escribe la contraseña (por ejemplo,
odoo
) y después haz clic en Guardar.Abre la pestaña Privilegios y cambia ¿Puede iniciar sesión? a
Sí
y ¿Crear una base de datos? aSí
.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Nota
El usuario de PostgreSQL tiene el mismo nombre que el inicio de sesión de Unix, así que es posible conectarse a la base de datos sin contraseña.
Dependencias¶
Usar paquetes de distribución es la forma recomendada de instalar dependencias. Como alternativa, instala las dependencias de Python con pip.
En Debian/Ubuntu, los siguientes comandos instalarán los paquetes necesarios:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
El script setup/debinstall.sh
analizará el archivo debian/control e instalará los paquetes que encuentre.
Advertencia
Usar pip puede ocasionar problemas de seguridad y dependencias rotas; hazlo solo si conoces el procedimiento con exactitud.
Algunos paquetes de Python necesitan un paso de compilación, así que las que las bibliotecas del sistema deben estar instaladas.
En Debian/Ubuntu, el siguiente comando instalará todas las bibliotecas necesarias:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Las dependencias de Odoo están en el archivo requirements.txt
que se encuentra en el directorio principal de la versión Community de Odoo.
Nota
Los paquetes de Python en requirements.txt
se basan en la versión estable/LTS correspondiente de Debian/Ubuntu en el momento del lanzamiento de Odoo. Por ejemplo, para Odoo 15.0, la versión del paquete python3-babel
es 2.8.0 en Debian Bullseye y 2.6.0 en Ubuntu Focal. En el archivo requirements.txt
se elige la versión más baja.
Truco
Es preferible que no mezcles paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, puedes usar virtualenv para crear entornos de Python aislados.
Ve a la ruta de la instalación de Odoo Community (CommunityPath
) y ejecuta pip en el archivo de requerimientos para instalar las dependencias para el usuario actual.
$ cd /CommunityPath
$ pip install -r requirements.txt
Antes de instalar las dependencias, descarga e instala las herramientas de creación «Build Tools» para Visual Studio. Selecciona C++ build tools o Herramientas de creación de C++ en la pestaña Carga de trabajo e instálalas cuando se te indique.
Las dependencias de Odoo están en el archivo requirements.txt
que se encuentra en el directorio principal de la versión Community de Odoo.
Truco
Es preferible que no mezcles paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, puedes usar virtualenv para crear entornos de Python aislados.
Ve a la ruta de la instalación de Odoo Community (CommunityPath
) y ejecuta pip en el archivo de requisitos en una terminal con privilegios de administrador:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Las dependencias de Odoo están en el archivo requirements.txt
que se encuentra en el directorio principal de la versión Community de Odoo.
Truco
Es preferible que no mezcles paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, puedes usar virtualenv para crear entornos de Python aislados.
Ve a la ruta de la instalación de Odoo Community (CommunityPath
) y ejecuta pip en el archivo de requisitos:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Nota
Instala el paquete rtlcss
para los idiomas que usan una interfaz de derecha a izquierda (como árabe o hebreo).
Descarga e instala nodejs y npm con un gestor de paquetes.
Instala
rtlcss
:$ sudo npm install -g rtlcss
Descarga e instala nodejs.
Instala
rtlcss
:C:\> npm install -g rtlcss
Edita la variable de entorno
PATH
del sistema para agregar la carpeta donde se encuentrartlcss.cmd
(que suele serC:\Users\<user>\AppData\Roaming\npm\
).
Advertencia
wkhtmltopdf
no está instalado mediante pip y debes instalarlo de forma manual en la versión 0.12.6 para que sea compatible con los encabezados y pies de páginas. Consulta la wiki de wkhtmltopdf para obtener más detalles sobre las diferentes versiones.
Ejecutar Odoo¶
Una vez que configures todas las dependencias, ejecuta odoo-bin
, la interfaz de línea de comandos del servidor, para iniciar Odoo. Está en el directorio principal de Odoo Community.
Para configurar el servidor debes especificar argumentos de la línea de comandos o un archivo de configuración.
Truco
Para la edición Enterprise, agrega la ruta de los módulos enterprise
al argumento addons-path
. Ten en cuenta que debe ir antes que las demás rutas en addons-path
para que estos complementos se carguen de forma correcta.
Estas son las configuraciones necesarias más comunes:
Usuario y contraseña de PostgreSQL.
Rutas de complementos personalizados fuera de las predeterminadas para cargar módulos personalizados.
Una forma típica de ejecutar el servidor sería:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Donde CommunityPath
es la ruta de la instalación de Odoo Community y mydb
es el nombre de la base de datos de PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Donde CommunityPath
es la ruta de la instalación de Odoo Community, dbuser
es el inicio de sesión de PostgreSQL, dbpassword
es la contraseña de PostgreSQL y mydb
es el nombre de la base de datos de PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Donde CommunityPath
es la ruta de la instalación de Odoo Community y mydb
es el nombre de la base de datos de PostgreSQL.
Cuando el servidor haya iniciado (aparece en el registro INFO odoo.modules.loading: Modules loaded.
), abre http://localhost:8069 en un navegador web e inicia sesión en la base de datos de Odoo con la cuenta de administrador base: usa admin
como correo y, de nuevo, admin
como contraseña.
Truco
Ver también