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

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.

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

Verifica que pip también esté instalado para esta versión.

$ 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

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.

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.

Nota

Instala el paquete rtlcss para los idiomas que usan una interfaz de derecha a izquierda (como árabe o hebreo).

  1. Descarga e instala nodejs y npm con un gestor de paquetes.

  2. Instala rtlcss:

    $ sudo npm install -g rtlcss
    

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.

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

  • Crea y gestiona nuevos usuarios desde ahí.

  • La cuenta de usuario que usas para iniciar sesión en la interfaz web de Odoo es diferente al argumento de CLI --db_user.