Fuente¶
La “instalación” de la fuente no se trata de instalar Odoo sino de ejecutarlo directamente desde la fuente.
Usar la fuente de Odoo puede ser más conveniente para los desarrolladores de módulos, ya que es más fácilmente accesible que usar instaladores empaquetados.
It makes starting and stopping Odoo more flexible and explicit than the services set up by the packaged installers. Also, it allows overriding settings using without needing to edit a configuration file.
Finalmente, proporciona un mayor control sobre la configuración del sistema y permite mantener (y ejecutar) más fácilmente múltiples versiones de Odoo en paralelo.
Obtener las fuentes¶
Hay dos formas de obtener el código fuente de Odoo: como archivo ZIP o a través de Git.
Archivo¶
Edición comunitaria:
Edición de Empresa:
git¶
Nota
Se requiere tener instalado Git y se recomienda tener conocimientos básicos de los comandos de Git para continuar.
To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone [email protected]:odoo/odoo.git
C:\> git clone [email protected]:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]:odoo/enterprise.git
Nota
El repositorio git de Enterprise no contiene el código fuente completo de Odoo. Es sólo una colección de complementos adicionales. El código del servidor principal está en la edición comunitaria. Ejecutar la versión Enterprise significa ejecutar el servidor desde la versión Community con la opción addons-path
configurada en la carpeta con la edición Enterprise. Es necesario clonar los repositorios Community y Enterprise para tener una instalación de Odoo Enterprise que funcione.
Preparar¶
Pitón¶
Odoo requiere Python 3.7 o posterior para ejecutarse.
Utilice un administrador de paquetes para descargar e instalar Python 3 si es necesario.
Descargue la última versión de Python 3 e instálela.
Durante la instalación, marque Agregar Python 3 a RUTA, luego haga clic en Personalizar instalación y asegúrese de que pip esté marcado.
Nota
Si Python 3 ya está instalado, asegúrese de que la versión sea 3.7 o superior, ya que las versiones anteriores no son compatibles con Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verifique 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.
Utilice un administrador de paquetes para descargar e instalar PostgreSQL (versiones compatibles: 12.0 o superior). Se puede lograr ejecutando lo siguiente:
$ sudo apt install postgresql postgresql-client
Descargue PostgreSQL (versiones compatibles: 12.0 o superior) e instálelo.
Utilice Postgres.app para descargar e instalar PostgreSQL (versión compatible: 12.0 o superior).
Truco
Para que las herramientas de línea de comandos incluidas con Postgres.app estén disponibles, asegúrese de configurar la variable $PATH
siguiendo las `instrucciones de las herramientas CLI de Postgres.app <https://postgresapp.com/documentation/cli-tools.html >`_.
Por defecto, el único usuario es «postgres». Como Odoo prohíbe conectarse como postgres
, cree un nuevo usuario de PostgreSQL.
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Nota
Debido a que el usuario de PostgreSQL tiene el mismo nombre que el usuario de Unix, es posible conectarse a la base de datos sin contraseña.
Agregue el directorio
bin
de PostgreSQL (por defecto:C:\Program Files\PostgreSQL\<versión>\bin
) a laPATH
.Cree un usuario de Postgres con una contraseña usando la interfaz gráfica de usuario de pg admin:
Abra pgAdmin.
Haga doble clic en el servidor para crear una conexión.
Seleccione :menuseleccion:`Objeto --> Crear --> Inicio de sesión/Rol de grupo`.
Ingrese el nombre de usuario en el campo Nombre de función (por ejemplo,
odoo
).Abra la pestaña Definición, ingrese una contraseña (por ejemplo,
odoo
) y haga clic en Guardar.Abra la pestaña Privilegios y cambie ¿Puede iniciar sesión? a «Sí» y ¿Crear base de datos? a «Sí».
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Nota
Debido a que el usuario de PostgreSQL tiene el mismo nombre que el usuario de Unix, es posible conectarse a la base de datos sin contraseña.
Dependencias¶
Usar paquetes de distribución es la forma preferida de instalar dependencias. Alternativamente, instale las dependencias de Python con pip.
For Debian-based systems, the packages are listed in the debian/control file of the Odoo sources.
En Debian/Ubuntu, los siguientes comandos deberían instalar los paquetes necesarios:
$ cd /CommunityPath
$ sed -n -e '/^Depends:/,/^Pre/ s/ python3-\(.*\),/python3-\1/p' debian/control | sudo xargs apt-get install -y
Como algunos de los paquetes de Python necesitan un paso de compilación, requieren la instalación de bibliotecas del sistema.
En Debian/Ubuntu, el siguiente comando debería instalar estas bibliotecas requeridas:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Las dependencias de Odoo se enumeran en el archivo requirements.txt
ubicado en la raíz del directorio de la comunidad de Odoo.
Nota
Los paquetes de Python en requirements.txt
se basan en su versión estable/LTS Debian/Ubuntu correspondiente 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. Luego se elige la versión más baja en el :archivo:`requirements.txt`.
Truco
Puede ser preferible no mezclar paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, es posible utilizar virtualenv para crear entornos Python aislados.
Navegue hasta la ruta de instalación de Odoo Community (:archivo:`CommunityPath`) y ejecute pip en el archivo de requisitos para instalar los requisitos para el usuario actual.
$ cd /CommunityPath
$ pip install -r requirements.txt
Antes de instalar las dependencias, descargue e instale Herramientas de compilación para Visual Studio. Seleccione Herramientas de compilación de C++ en la pestaña Cargas de trabajo e instálelas cuando se le solicite.
Las dependencias de Odoo se enumeran en el archivo requirements.txt
ubicado en la raíz del directorio de la comunidad de Odoo.
Truco
Puede ser preferible no mezclar paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, es posible utilizar virtualenv para crear entornos Python aislados.
Navegue hasta la ruta de instalación de Odoo Community (CommunityPath
) y ejecute 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 se enumeran en el archivo requirements.txt
ubicado en la raíz del directorio de la comunidad de Odoo.
Truco
Puede ser preferible no mezclar paquetes de módulos de Python entre diferentes instancias de Odoo o con el sistema. Sin embargo, es posible utilizar virtualenv para crear entornos Python aislados.
Navegue hasta la ruta de instalación de Odoo Community (CommunityPath
) y ejecute pip en el archivo de requisitos:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Nota
Para los idiomas que utilizan una interfaz de derecha a izquierda (como el árabe o el hebreo), se requiere el paquete rtlcss
.
Descargue e instale nodejs y npm con un administrador de paquetes.
Instale
rtlcss
:$ sudo npm install -g rtlcss
Descargue e instale nodejs.
Instale
rtlcss
:C:\> npm install -g rtlcss
Edite la variable de entorno del sistema
PATH
para agregar la carpeta donde se encuentrartlcss.cmd
(normalmente:C:\Users\<user>\AppData\ Roaming\npm\
).
Advertencia
wkhtmltopdf
no se instala a través de pip y debe instalarse manualmente en la versión 0.12.5 para que sea compatible encabezados y pies de pagina. Consulte la wkhtmltopdf wiki para obtener más detalles sobre las distintas versiones.
ejecutando odoo¶
Una vez configuradas todas las dependencias, se puede iniciar Odoo ejecutando odoo-bin
, la interfaz de línea de comandos del servidor. Está ubicado en la raíz del directorio de la Comunidad Odoo.
Truco
Para la edición Enterprise, agregue la ruta a los complementos «enterprise» al argumento «addons-path». Tenga en cuenta que debe aparecer antes que las otras rutas en addons-path
para que los complementos se carguen correctamente.
Las configuraciones necesarias comunes son:
Usuario y contraseña de PostgreSQL.
Rutas de complementos personalizadas más allá 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 instalación de la comunidad Odoo y mydb
es el nombre de la base de datos PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Donde CommunityPath
es la ruta de instalación de la comunidad Odoo, 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 instalación de la comunidad Odoo y mydb
es el nombre de la base de datos PostgreSQL.
Después de que el servidor se haya iniciado (se imprime el registro de INFORMACIÓN odoo.modules.loading: Módulos cargados
), abra http://localhost:8069 en un navegador web e inicie sesión en la base de datos de Odoo con la cuenta de administrador base: use ` admin` como correo electrónico y, nuevamente, admin
como contraseña.