Instalar Odoo¶
Hay varias maneras de instalar Odoo, o no instalarlo, dependiendo del caso de uso.
En este documento intentamos describir la mayoría de las opciones de instalación.
- En línea
La manera más fácil de usar Odoo en producción o de intentarlo.
- Paquete de instaladores
Ideal para realizar pruebas, desarrollar módulos y se puede usar para una producción a largo término, use con un despliegue adicional y trabajo de mantenimiento.
- Source Install
Brinda mayor flexibilidad, por ejemplo, permite que hayan múltiples versiones de Odoo en un mismo sistema. Excelente para desarrollar módulos, puede usarse como una base para producción o despliegue.
- Docker
Si usualmente usa docker para desarrollo o despliegue, está disponible una imagen oficial de docker base
Ediciones¶
Hay dos Editions diferentes de Odoo: Community y Enterprise. Se puede usar la versión SaaS y si ingresar el código está restringido a clientes y partner Enterprise. La versión de comunidad siempre está disponible para todos.
Si ya usa la versión Community y desea mejorar a la versión Enterprise, vaya a Actualizar de Community a Enterprise (excepto por Source Install)
En línea¶
Demostración¶
Para hacerse una idea rápida de Odoo, las instancias demo están disponibles. Son instancias compartidas que solo viven un par de horas y se pueden usar para navegar por la aplicación sin ningún compromiso.
Las instancias demo no necesitan instalación local, solo un navegador web.
SaaS¶
El SaaS de Odoo es trivial para empezar y Odoo S.A. lo gestiona y migra. Además, el SaaS de Odoo proporciona instancias privadas y es gratis al inicio. Lo puede usar para descubrir y probar Odoo, así como para realizar personalizaciones que no requieran trabajar con código (es decir, que no sean compatibles con los módulos personalizados o la tienda de aplicaciones de Odoo) sin tener que instalarlo localmente.
Se puede usar tanto para probar Odoo como para la producción a largo plazo.
Como las instancias demo, las instancias SaaS no necesitan instalación local, solo un navegador web.
Paquete de instaladores¶
Odoo tiene instaladores en paquetería para Windows, distribuciones basadas en debian (Debian, Ubuntu, …) y basadas en RPM (Fedora, CenOS, RHEL, …) tanto para las versiones Community como para las versiones Enterprise.
Estos paquetes configuran automáticamente todas las dependencias (para la versión Community), pero puede ser difícil mantenerlas actualizadas.
Los paquetes oficiales de Community con todos los requisitos relevantes de dependencias están disponibles en el servidor nightly. Tanto los paquetes de Community como los de Enterprise se pueden descargar desde nuestra página de descargas (debe haber iniciado sesión como un cliente de paga o un partner para descargar los paquetes de Enterprise).
Windows¶
Descargue el instalador de nuestro servidor nightly (solo en Community) o el instalador Windows desde la página de download (cualquier edición).
Ejecutar el archivo descargado.
Advertencia
En Windows 8 y posteriores puede que vea una advertencia con el título «Windows protegió su PC».Haga clic en más información y después en ejecutar de todas formas.Aceptar el prompt UAC.
Pase por los diferentes pasos de instalación.
Odoo se ejecutará automáticamente al finalizar la instalación.
Linux¶
Debian/Ubuntu¶
Odoo 13.0 “deb” package currently supports Debian Buster, Ubuntu 18.04 or above.
Preparar¶
Odoo necesita un servidor PostgreSQL para ejecutarse como se debe. La configuración automática para el paquete “deb” de Odoo es usar el servidor PostgreSQL en el mismo alojamiento que su instancia Odoo. Ejecute este comando para poder instalar el servidor PostgreSQL:
$ sudo apt install postgresql -y
Repositorio¶
Odoo S.A. cuenta con un repositorio que puede usarse con distribuciones Debian y Ubuntu. Se puede usar para instalar La edición Community de Odoo ejecutando el siguiente comando como raíz:
# wget -O - https://nightly.odoo.com/odoo.key | apt-key add -
# echo "deb http://nightly.odoo.com/13.0/nightly/deb/ ./" >> /etc/apt/sources.list.d/odoo.list
# apt-get update && apt-get install odoo
Puede usar el comando usual apt-get upgrade
para mantener su instalación actualizada.
En este momento, no hay un repositorio nightly para la edición Enterprise.
Paquete deb¶
En lugar de usar el repositorio como se describe arriba, los paquetes “deb” de la edición Community o Enterprise se pueden descargar desde la página oficial de descarga.
Ahora, ejecute estos comandos como raíz:
# dpkg -i <path_to_installation_package> # this probably fails with missing dependencies
# apt-get install -f # should install the missing dependencies
# dpkg -i <path_to_installation_package>
Así se instalará Odoo como un servicio, cree el usuario PostgreSQL necesario y automáticamente inicie el servidor.
Advertencia
El paquete debian python3-xlwt
no existe en Debian Buster ni en Ubuntu 18.04. Este módulo de python se necesita para exportarlo a formato xls.
Si necesita la función, puede instalarla manualmente con:
$ sudo pip3 install xlwt
Advertencia
El paquete python num2words
no existe en Debian Buster ni Ubuntu 18.04. Odoo no renderizará las cantidades textuales y esto podría causar problemas con el módulo l10n_mx_edi
.
Si necesita esta función, la puede instalar manualmente con:
$ sudo pip3 install num2words
Fedora¶
Odoo 13.0 “rpm” package supports Fedora 30.
Preparar¶
Odoo necesita un servidor PostgreSQL para funcionar adecuadamente. Asegúrese de que el comando sudo
esté disponible y bien configurado y, solo entonces, ejecute el siguiente comando para poder instalar el servidor PostgreSQL:
$ sudo dnf install -y postgresql-server
$ sudo postgresql-setup --initdb --unit postgresql
$ sudo systemctl enable postgresql
$ sudo systemctl start postgresql
Repositorio¶
Odoo S.A. cuenta con un repositorio que se puede usar con distribuciones de Fedora. Se puede usar para instalar la edición Community de Odoo* si ejecuta los siguientes comandos:
$ sudo dnf config-manager --add-repo=https://nightly.odoo.com/13.0/nightly/rpm/odoo.repo
$ sudo dnf install -y odoo
$ sudo systemctl enable odoo
$ sudo systemctl start odoo
Paquete RPM¶
En lugar de usar el repositorio como se describe arribe, los paquetes “rpm” para las ediciones Community y Enterprise se pueden descargar desde la página oficial de descargas.
Una vez que lo descargue, el paquete se instalará usando el gestor del paquete “dnf”:
$ sudo dnf localinstall odoo_13.0.latest.noarch.rpm
$ sudo systemctl enable odoo
$ sudo systemctl start odoo
Source Install¶
La «instalación» de origen no es sobre instalar Odoo, sino sobre ejecutarlo directamente desde el origen.
Esto puede ser más conveniente para desarrolladores de módulos ya que es más fácil acceder al origen de Odoo que usar la instalación de paquete (para más información o para construir esta documentación y tenerla disponible fuera de línea).
También hace que el iniciar y detener Odoo sea más flexible y explícito que los servicios que las instalaciones en paquete configuraron, además de que permite sobrescribir los ajustes usando parámetros de líneas de comando sin tener que editar el archivo de configuración.
Finalmente, permite tener más control sobre la configuración del sistema y hace que sea más fácil mantener (y ejecutar) varias versiones de Odoo al mismo tiempo.
Windows¶
Extraer los recursos¶
Hay dos maneras de obtener el código fuente de Odoo: desde un archivo zip o git.
Archivar¶
Edición community:
Edición Enterprise:
Git¶
The following requires git to be installed on your machine and that you have basic knowledge of git commands.
Edición community:
C:\> git clone https://github.com/odoo/odoo.git
Enterprise Edition: (see Ediciones to get access)
C:\> git clone https://github.com/odoo/enterprise.git
Nota
The Enterprise git repository does not contain the full Odoo source code. It is only a collection of extra add-ons. The main server code is in the Community version. Running the Enterprise version actually means running the server from the Community version with the addons-path option set to the folder with the Enterprise version. You need to clone both the Community and Enterprise repository to have a working Odoo Enterprise installation.
Preparar¶
Python¶
Odoo requires Python 3.6 or later to run. Visit Python’s download page to download and install the latest version of Python 3 on your machine.
Durante la instalación, marque Agregue Python 3 a la RUTA, después haga clic en Personalización de la instalación y asegúrese de que pip esté revisado.
Nota
If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.
C:\> python --version
También verifique que pip esté instalado para esta versión.
C:\> pip --version
PostgreSQL¶
Odoo usa PostgreSQL como un sistema de gestión de base de datos. Descargue e instale PostgreSQL (versión compatible: 10.0 y más avanzados).
Por defecto, el único usuario es postgres
pero Odoo no permite conectarse como postgres
, así que necesita crear un nuevo usuario de PostgreSQL:
Agregue el directorio de
papelera
de PostgreSQL (por defecto:C:\Program Files\PostgreSQL\<version>\bin
) a suRUTA
.Cree un usuario postgres con una contraseña usando la guía pgAdmin:
Abrir pgAdmin.
Haga doble clic en el servidor para crear una conexión.
Seleccione
.Ingrese el nombre de usuario en el campo de Nombre de la función (por ejemplo,
odoo
)Abra la pestaña de Definición ingrese la contraseña (por ejemplo,
odoo
), después haga clic en Guardar.Abra la pestaña de Privilegios y cambie ¿Puede iniciar sesión? a
Sí
y ¿Crear una base de datos? aSí
.
Dependencias¶
Antes de instalar las dependencias, debe descargar e instalar Herramientas de creación para Visual Studio. Cuando se lo pida, seleccione herramientas de creación C++ en la pestaña de Carga de trabajo e instálelo.
Las dependencias de Odoo están enlistadas en el archivo requirements.txt
que se encuentra en la raíz del directorio de Odoo community.
Truco
Puede ser mejor no mezclar los paquetes de módulos python entre diferentes instancias de Odoo o con su sistema. Puede usar vitualenv para crear entornos Python aislados.
Navegue a la ruta de su instalación de Odoo Community (CommunityPath
) y ejecute pip en el campo de requisitos en una terminal con privilegios de administrador:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Advertencia
wkhtmltopdf
no está instalado mediante pip y debe instalarse manualmente en la versión 0.12.5 para que sea compatible con los encabezados y pies de páginas. Vea nuestra wiki para obtener más detalles sobre las diferentes versiones.
Para idiomas que funcionan con una interfaz de izquierda a derecha (como las interfaces de árabe y hebreo) se necesita el paquete rtlcss
:
Descargue e instale nodejs.
Instale
rtlcss
:C:\> npm install -g rtlcss
Edite la
RUTA
variable del entorno del sistema para agregar la carpeta donde se encuentrartlcss.cmd
(típicamente:C:\Users\<user>\AppData\Roaming\npm\
).
Ejecutar Odoo¶
Una vez que todas las dependencias estén configuradas, Odoo puede iniciarse ejecutando odoo-bin
, la interfaz de la línea de comando del servidor. Se encuentra en la raíz del directorio de Odoo Community.
Para configurar el servidor puede especificar argumentos de las líneas de comando o un archivo de configuración.
Truco
Para la edición de Enterprise, necesita agregar la ruta de los complementos de enterprise
al argumento de addons-path
. Tenga en cuenta que debe ser antes que otras rutas en addons-path
para que los complementos se carguen correctamente.
Estas son las configuraciones necesarias más comunes:
Usuario y contraseña de PostgreSQL
Rutas de complementos personalizadas más allá de lo predeterminado para cargar los módulos.
Una forma típica de ejecutar el servidor sería:
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Where CommunityPath
is the path of the Odoo Community installation, dbuser
is the
PostgreSQL login, dbpassword
is the PostgreSQL password
and mydb
is the default database to serve on localhost:8069
.
Ver también
Linux¶
Extraer los recursos¶
Hay dos maneras de obtener el código fuente de Odoo: desde un archivo zip o git.
Archivar¶
Edición community:
Edición Enterprise:
Git¶
The following requires git to be installed on your machine and that you have basic knowledge of git commands.
Edición community:
$ git clone https://github.com/odoo/odoo.git
Enterprise Edition: (see Ediciones to get access)
$ git clone https://github.com/odoo/enterprise.git
Nota
The Enterprise git repository does not contain the full Odoo source code. It is only a collection of extra add-ons. The main server code is in the Community version. Running the Enterprise version actually means running the server from the Community version with the addons-path option set to the folder with the Enterprise version. You need to clone both the Community and Enterprise repository to have a working Odoo Enterprise installation.
Preparar¶
Python¶
Odoo requires Python 3.6 or later to run. Use your package manager to download and install Python 3 on your machine if it is not already done.
Nota
If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.
$ python3 --version
También verifique que pip esté instalado para esta versión.
$ pip3 --version
PostgreSQL¶
Odoo usa PostgreSQL sistema de gestión de base de datos. Use su gestor de paquetes para descargar e instalar PostgreSQL (versión compatible: 10.0 y más avanzadas).
En Debian/Ubuntu, se puede lograr ejecutando lo siguiente:
$ sudo apt install postgresql postgresql-client
Por defecto, el único usuario es postgres
pero Odoo no permite conectarse como postgres
, así que necesita crear un nuevo usuario de PostgreSQL:
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Nota
Ya que su usuario de PostgreSQL tiene el mismo nombre que su inicio de sesión de Unix, podrá conectarse a la base de datos sin una contraseña.
Dependencias¶
Para librerías que usan código nativo es necesario instalar herramientas de desarrollo y dependencias nativas antes de instalar las dependencias Python de Odoo. Están disponibles en los paquetes -dev
o -devel
para Python, PostgreSQL, libxml2, libxslt1, libevent, libsasl2 y libldap2.
En Debian/Ubuntu, este comando debería de instalar todas las bibliotecas necesarias:
$ sudo apt install python3-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev libfreetype6-dev \
liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev libpq-dev
Las dependencias de Odoo están enlistadas en el archivo requirements.txt
que se encuentra en la raíz del directorio de Odoo community.
Truco
Puede ser mejor no mezclar los paquetes de módulos python entre diferentes instancias de Odoo o con su sistema. Puede usar vitualenv para crear entornos Python aislados.
Vaya a la ruta de su instalación de Odoo Community (CommunityPath
) y ejecute pip en el archivo de solicitudes:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Advertencia
wkhtmltopdf
no está instalado mediante pip y debe instalarse manualmente en la versión 0.12.5 para que sea compatible con los encabezados y pies de páginas. Vea nuestra wiki para obtener más detalles sobre las diferentes versiones.
Para idiomas que funcionan con una interfaz de izquierda a derecha (como las interfaces de árabe y hebreo) se necesita el paquete rtlcss
:
Descargue e instale nodejs y npm con su gestor de paquetería.
Instale
rtlcss
:$ sudo npm install -g rtlcss
Ejecutar Odoo¶
Una vez que todas las dependencias estén configuradas, Odoo puede iniciarse ejecutando odoo-bin
, la interfaz de la línea de comando del servidor. Se encuentra en la raíz del directorio de Odoo Community.
Para configurar el servidor puede especificar argumentos de las líneas de comando o un archivo de configuración.
Truco
Para la edición de Enterprise, necesita agregar la ruta de los complementos de enterprise
al argumento de addons-path
. Tenga en cuenta que debe ser antes que otras rutas en addons-path
para que los complementos se carguen correctamente.
Estas son las configuraciones necesarias más comunes:
Usuario y contraseña de PostgreSQL. Odoo no tiene predeterminados fuera de los predeterminados psycopg2: conecta con un socket UNIX en el puerto
5432
con el usuario actual y sin contraseña.Rutas de complementos personalizadas más allá de lo predeterminado para cargar los módulos.
Una forma típica de ejecutar el servidor sería:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Where CommunityPath
is the path of the Odoo Community installation
and mydb
is the default database to serve on localhost:8069
.
Ver también
Mac OS¶
Extraer los recursos¶
Hay dos maneras de obtener el código fuente de Odoo: desde un archivo zip o git.
Archivar¶
Edición community:
Edición Enterprise:
Git¶
The following requires git to be installed on your machine and that you have basic knowledge of git commands.
Edición community:
$ git clone https://github.com/odoo/odoo.git
Enterprise Edition: (see Ediciones to get access)
$ git clone https://github.com/odoo/enterprise.git
Nota
The Enterprise git repository does not contain the full Odoo source code. It is only a collection of extra add-ons. The main server code is in the Community version. Running the Enterprise version actually means running the server from the Community version with the addons-path option set to the folder with the Enterprise version. You need to clone both the Community and Enterprise repository to have a working Odoo Enterprise installation.
Preparar¶
Python¶
Odoo requires Python 3.6 or later to run. Use your preferred package manager (homebrew, macports) to download and install Python 3 on your machine if it is not already done.
Nota
If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.
$ python3 --version
También verifique que pip esté instalado para esta versión.
$ pip3 --version
PostgreSQL¶
Odoo usa PostgreSQL como sistema de gestión de base de datos. Use postgres.app para descargar e instalar PostgreSQL (versión compatible: 10.0 y más avanzadas).
Por defecto, el único usuario es postgres
pero Odoo no permite conectarse como postgres
, así que necesita crear un nuevo usuario de PostgreSQL:
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Nota
Ya que su usuario de PostgreSQL tiene el mismo nombre que su inicio de sesión de Unix, podrá conectarse a la base de datos sin una contraseña.
Dependencias¶
Las dependencias de Odoo están enlistadas en el archivo requirements.txt
que se encuentra en la raíz del directorio de Odoo community.
Truco
Puede ser mejor no mezclar los paquetes de módulos python entre diferentes instancias de Odoo o con su sistema. Puede usar vitualenv para crear entornos Python aislados.
Vaya a la ruta de su instalación de Odoo Community (CommunityPath
) y ejecute pip en el archivo de solicitudes:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Advertencia
Las dependencias que no sean Python necesitan instalarse con un gestor de paquetes:
Advertencia
wkhtmltopdf
no está instalado mediante pip y debe instalarse manualmente en la versión 0.12.5 para que sea compatible con los encabezados y pies de páginas. Vea nuestra wiki para obtener más detalles sobre las diferentes versiones.
Para idiomas que funcionan con una interfaz de izquierda a derecha (como las interfaces de árabe y hebreo) se necesita el paquete rtlcss
:
Ejecutar Odoo¶
Una vez que todas las dependencias estén configuradas, Odoo puede iniciarse ejecutando odoo-bin
, la interfaz de la línea de comando del servidor. Se encuentra en la raíz del directorio de Odoo Community.
Para configurar el servidor puede especificar argumentos de las líneas de comando o un archivo de configuración.
Truco
Para la edición de Enterprise, necesita agregar la ruta de los complementos de enterprise
al argumento de addons-path
. Tenga en cuenta que debe ser antes que otras rutas en addons-path
para que los complementos se carguen correctamente.
Estas son las configuraciones necesarias más comunes:
Usuario y contraseña de PostgreSQL. Odoo no tiene predeterminados fuera de los predeterminados psycopg2: conecta con un socket UNIX en el puerto
5432
con el usuario actual y sin contraseña.Rutas de complementos personalizadas más allá de lo predeterminado para cargar los módulos.
Una forma típica de ejecutar el servidor sería:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Where CommunityPath
is the path of the Odoo Community installation
and mydb
is the default database to serve on localhost:8069
.
Ver también
Docker¶
La documentación completa sobre cómo usar Odoo con Docker se puede encontrar en la página oficial de Odoo imágen de Odoo.