Guía para la Instalación de Odoo 17 Community Edition

Bienvenida

Esta guía está diseñada para facilitarle el proceso de instalación de Odoo 17 en un

servidor Ubuntu, paso a paso. Ya sea que su servidor esté alojado en la nube o
configurado localmente, encontrará instrucciones claras y concisas para una
instalación exitosa. Descargue la Guía de Instalación Odoo 17 FULL.
Recomendaciones Preliminares

Le recomendamos encarecidamente optar por Ubuntu como sistema operativo para

su instalación de Odoo. Aunque es posible realizar la instalación en Windows o Mac,
estas plataformas presentan limitaciones, como la imposibilidad de utilizar múltiples
hilos o “workers”, lo que puede limitar significativamente el rendimiento.
Uso de Entorno Virtual

Para garantizar una instalación limpia y sin conflictos, le mostraremos cómo instalar
Odoo dentro de un entorno virtual. Este método es ideal para evitar interferencias
con otros servicios o versiones de Odoo que desee instalar en el futuro.

Solución de Problemas

Si se encuentra con obstáculos durante la instalación, primero verifique que ha

cumplido con todos los requisitos previos. Asegúrese de estar utilizando la cuenta
de usuario correcta y de tener activado el entorno virtual cuando sea necesario.
Siguiendo estas instrucciones en orden, el proceso debería ser fluido y sin
complicaciones.
Consejos de Expertos

No se preocupe si al principio el proceso le parece desafiante. Incluso los expertos

tuvieron que comenzar por algún lugar. Implementar un sistema ERP como Odoo
requiere habilidades especializadas y experiencia. Sin embargo, con esta guía y
práctica, pronto se familiarizará con el proceso.
Asistencia Profesional

Si no tiene experiencia previa en la implementación de sistemas empresariales, le

ofrecemos la posibilidad de contar con la ayuda de un consultor de SofBiz
Technologies. Esta opción puede ahorrarle tiempo y evitar posibles frustraciones.
Contacto

Para cualquier consulta o si desea asistencia personalizada en la configuración de

su instalación de Odoo, no dude en escribirnos a info.sofbiz@gmail.com.

Agradecimientos

Gracias por elegir esta guía. Esperamos que le sea de gran ayuda en su camino
hacia una exitosa implementación de Odoo.

Aaron Ballesteros

Fundador de www.sofbiz.pe
Requisitos y Pre-Requisitos para la Instalación de Odoo 17
Configuración del Servidor

Para comenzar, es esencial contar con un servidor Ubuntu 22.04.1 previamente

configurado y listo para la instalación de Odoo 17. Recomendamos el uso de un VPS
en la nube de proveedores como Contabo, IONOS, AWS, GCP, o similares.
Alternativamente, puede optar por una máquina virtual local en VirtualBox con
Ubuntu 22.04.1, lo cual puede resultar en un ahorro económico. La configuración y
los comandos de instalación serán idénticos en ambos casos.
Editor de Texto Nano

Durante la instalación, utilizaremos el editor de texto Nano, integrado en Ubuntu

22.04.1. Si no está familiarizado con Nano, aquí le ofrecemos algunos consejos
básicos:
● Pegar Código: Para pegar texto en Nano, sitúe el cursor en la ubicación
deseada y utilice el botón derecho del ratón para pegar el texto. No es posible
usar el ratón para mover el cursor dentro de Nano; utilice las flechas del
teclado.
● Guardar Cambios: Para guardar modificaciones en Nano, presione Ctrl-O. Se
le solicitará confirmar o cambiar el nombre del archivo.
● Salir de Nano: Para cerrar Nano, simplemente presione Ctrl-X.

Desactivación del Almacenamiento en Caché del Navegador

Es recomendable desactivar el almacenamiento en caché del navegador durante la

instalación de Odoo 17, especialmente al configurar Nginx y los certificados SSL.
Una alternativa es utilizar el modo incógnito, evitando así interferencias con la
memoria caché que podrían ocasionar confusión respecto a los cambios realizados.
Instalación para Diferentes Entornos

Esta guía está diseñada para asistirle en la instalación de Odoo 17 en diversos

entornos, ya sea de desarrollo, pruebas o producción.

● Entorno de Desarrollo: Ideal para personalizar Odoo 17 o desarrollar

aplicaciones. Busca una instalación rápida y manejable, sin necesidad de
configurar como servicio o proxy inverso bajo nginx.
● Entorno de Pruebas: Replica lo más fielmente posible el entorno de
producción. Utilícelo para probar actualizaciones y nuevas funcionalidades,
asegurándose de que funcionen correctamente antes de su implementación
en producción.
 ● Entorno de Producción: Requiere atención adicional en la configuración y
pruebas exhaustivas bajo cargas de trabajo intensas. Generalmente, se
configura para un modo multiproceso, optimizando el rendimiento según los
usuarios, CPU y RAM disponibles.
Renovación Automática del Certificado SSL

Siga los pasos indicados en esta guía para configurar la renovación automática del
certificado SSL. De no hacerlo, el certificado expirará a los 90 días, dejando el
entorno de producción inaccesible hasta obtener un nuevo certificado.
Guía de Instalación Odoo 17 - Parte 1: Ambiente de Desarrollo
Descargue la Guía de instalación gratuita

Acceso al Servidor VPS o VirtualBox

Inicie su aventura de instalación de Odoo 17 accediendo a su VPS con una

herramienta como Putty.

● Usuario: root (o cualquier otro superusuario, utilizando ‘sudo’ antes de los

comandos)
● Contraseña: (utilice su propia contraseña segura)

Evaluación de Recursos del VPS o VirtualBox

Antes de sumergirse en la instalación, es prudente evaluar las capacidades de su

VPS.

● Versión de Ubuntu: Ejecute # cat /etc/os-release para confirmar la versión del

sistema operativo.
● Recursos de Procesamiento y Memoria: Instale y ejecute # htop para
visualizar el uso de recursos.
● Espacio de Disco: Utilice # df -h para revisar la asignación de espacio en
disco.
Actualización del Sistema y Paquetes

Actualice las aplicaciones del servidor con:

sudo apt update

Luego, actualice los paquetes existentes con:

sudo apt upgrade

Instalación de Paquetes Necesarios

Proceda a instalar los paquetes necesarios para Odoo 17 PostgreSQL (versiones

compatibles: 12.0 o superior) con:

sudo apt install postgresql postgresql-server-dev-14

Python (versión mínima actualizada de 3.7 a 3.10) y otros paquetes esenciales con:
sudo apt install build-essential python3-pillow python3-lxml python3-dev python3-pip python3-setuptools npm nodejs git gdebi
libldap2-dev libsasl2-dev libxml2-dev python3-wheel python3-venv libxslt1-dev node-less libjpeg-dev

Inicialización de PostgreSQL 14 Server

Verifique la versión con:

psql --version

Compruebe el estado del servicio con:

sudo systemctl status postgresql

Inicie el servidor PostgreSQL con:

sudo pg_ctlcluster 14 main start

Creación de Usuario del Sistema

● Por seguridad, es recomendable ejecutar Odoo 17 con un usuario sin

permisos de sudo.
● Cree un usuario llamado “odoo17” con:

sudo useradd -m -d /opt/odoo17 -U -r -s /bin/bash odoo17

Configuración de PostgreSQL

● Tras instalar PostgreSQL, cree un usuario de PostgreSQL con el mismo

nombre que el usuario del sistema con:

sudo su - postgres -c "createuser -s odoo17"

Instalación de Wkhtmltopdf

● Wkhtmltopdf es necesario para imprimir informes en PDF desde Odoo.

● Descargue el paquete con:
sudo wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb

● Instale Wkhtmltopdf con:

sudo apt install ./wkhtmltox_0.12.6.1-3.jammy_amd64.deb

Nota: Asegúrese de que los comandos estén en una sola línea al ejecutarlos.
Guía de Instalación de Odoo 17 - Ambiente Virtual
Preparación del Ambiente Virtual

La instalación de Odoo en un ambiente virtual de Python es crucial para mantenerlo

aislado de otros servicios y aplicaciones en su servidor Ubuntu.
Cambie al usuario “odoo17” con el comando:
sudo su - odoo17

Este paso es fundamental para asegurar que el código fuente se descargue con los
permisos adecuados.

Clonación del Código Fuente

Clone el código fuente de Odoo 17 desde GitHub al directorio local en su servidor
Ubuntu:
git clone https://www.github.com/odoo/odoo --depth 1 --branch 17.0 /opt/odoo17/odoo

Creación del Ambiente Virtual

Navegue al directorio de Odoo y cree el ambiente virtual:
cd /opt/odoo17
python3 -m venv odoo-venv

Active el ambiente virtual con:

source odoo-venv/bin/activate

La línea de comandos cambiará para indicar que está operando dentro del ambiente
virtual.

Instalación de Dependencias
Instale las dependencias necesarias de Odoo con los siguientes comandos:
pip3 install wheel
pip3 install -r odoo/requirements.txt

Prueba Inicial de la Instalación de Odoo

Asegúrese de que el puerto 8069 esté abierto en su servidor Ubuntu para poder
probar Odoo en su navegador.
Navegue al directorio fuente de Odoo e inicie la aplicación:
cd /opt/odoo17/odoo
./odoo-bin

Si Odoo inicia correctamente, verá un mensaje indicando que está ejecutándose en

el puerto 8069.

Acceso a Odoo desde el Navegador

Abra su navegador y diríjase a la siguiente dirección:
http://<tu_dominio_o_dirección_IP>:8069
En el caso de una prueba local, utilice:
127.0.0.1:8069

Si todo está configurado correctamente, se le solicitará crear una base de datos de

Odoo.

La pantalla debería verse así:

Para detener Odoo y continuar con la instalación, regrese a la terminal y presione
Ctrl-C.
Configuración de Odoo para Ejecutar Módulos Adicionales
Personalizados
Desactivación del Ambiente Virtual

Para comenzar la configuración de módulos adicionales, primero desactive su

ambiente virtual con el comando:
deactivate

Activación del Ambiente Virtual

Si necesita probar Odoo nuevamente, ubíquese en el directorio de Odoo 17 con:

cd /opt/odoo17

Y active el ambiente virtual con:

source odoo-venv/bin/activate

Creación de Directorio para Módulos Adicionales

Antes de crear un nuevo directorio para módulos adicionales y aplicaciones

personalizadas de Odoo, asegúrese de desactivar el ambiente virtual con

deactivate

Luego, como usuario odoo17, cree el directorio con:

mkdir /opt/odoo17/odoo-custom-addons

Este directorio será referenciado más adelante en el archivo de configuración de

Odoo bajo el parámetro addons_path.

Retorno al Usuario Sudo

Para continuar con la configuración, regrese a su usuario Sudo con

exit

Asegúrese de no seguir utilizando el usuario odoo17.

Creación de Archivo de Configuración de Odoo

Aunque es posible iniciar Odoo con ./odoo-bin, es necesario crear un archivo de

configuración para especificar parámetros e interruptores. Esto facilitará que Odoo
se inicie automáticamente tras reiniciar el servidor.
Cree el archivo de configuración con:
sudo nano /etc/odoo17.conf
En el editor Nano, copie el siguiente código:
[options]
; Especifique la contraseña que permite la gestión de la base de datos:
admin_passwd = admin_passwd
db_host = False
db_port = False
db_user = odoo17
db_password = False
addons_path = /opt/odoo17/odoo/addons,/opt/odoo17/odoo-custom-addons
; Es el puerto predeterminado. Se especifica aquí, si está ejecutando Odoo en un
puerto alternativo.
xmlrpc_port = 8069
; Es el puerto de longpolling predeterminado. Al igual que xmlrpc_port, estamos
especificando este puerto para completar
longpolling_port = 8072
; Si planea configurar nginx, se recomienda especificar varios trabajadores en la
configuración.
; Si no establece esto en workers > 1, entonces podría tener problemas cuando
especifique
; los long polling blocks en el archivo de configuración de nginx.
workers = 2
; Deberá agregar un filtro db a su archivo de configuración si tiene más de una base de
datos.
; Los ; significa que el comando está comentado. Quitar el comentario
; y especifique la base de datos para que su instalación de Odoo sepa exactamente
qué base de datos usar para la instancia.
; dbfilter = [your database]

ADVERTENCIA: Cambie el admin_passwd por una contraseña segura para proteger

su instalación de Odoo.

Para salir de Nano, presione Ctrl-X, luego Y y finalmente ENTER.

Nota: Los comentarios (líneas con ; al principio) en el archivo de configuración

ofrecen consejos sobre el uso de cada parámetro. Puede retirarlos si le ocasionan
problemas.

Configuración de Systemd para Inicio Automático de Odoo

Creación del Archivo de Unidad Systemd
Para asegurar que Odoo se inicie automáticamente tras un reinicio del servidor,
necesitamos crear un archivo de unidad Systemd. Abra el editor Nano con el
siguiente comando:
sudo nano /etc/systemd/system/odoo17.service

Edición del Archivo de Servicio

Dentro de Nano, copie y pegue el siguiente contenido para configurar el servicio (use
autoclick del mouse para pegar):
[Unit]
Description=Odoo17
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo17
PermissionsStartOnly=true
User=odoo17
ExecStart=/opt/odoo17/odoo-venv/bin/python3 /opt/odoo17/odoo/odoo-bin -c
/etc/odoo17.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

Para guardar y salir de Nano, presione Ctrl-X, luego Y, y finalmente ENTER.

Notificación al Sistema de los Cambios

Después de crear el archivo, informe al sistema de Ubuntu sobre el nuevo servicio

con:
sudo systemctl daemon-reload

Habilitación e Inicio del Servicio de Odoo

Inicie y habilite el servicio de Odoo para que se ejecute en el arranque del servidor:
sudo systemctl enable --now odoo17

Verificación del Estado del Servicio

Para confirmar que el servicio de Odoo está activo y en ejecución, utilice:

sudo systemctl status odoo17

La salida debería verse algo parecido a lo que se muestra continuación, lo que indica
que el servicio Odoo está activo y en ejecución:
TIP: Cada instalación tendrá sus propios ID de proceso únicos.

Para salir Ctrl-c

Si desea ver los mensajes registrados por el servicio Odoo, use el siguiente
comando:
***sudo journalctl -u odoo17
Prueba de la Instalación de Odoo
Acceso a Odoo desde el Navegador

Para verificar la instalación de Odoo, abra su navegador preferido (recomendado:

Chrome) y diríjase a:
http://<tu_dominio_o_dirección_IP>:8069

En un entorno de prueba local, utilice:

127.0.0.1:8069

Se le solicitará crear una base de datos de Odoo. Si ya realizó una prueba previa, es
posible que acceda directamente a la base de datos existente.

Configuración de Credenciales

Complete los siguientes campos para configurar su base de datos de Odoo:

● Contraseña Maestra: Utilice la misma que especificó en el archivo de

configuración (/etc/odoo17.conf).
● Nombre de la Base de Datos: Elija un nombre para su base de datos, por
ejemplo, desarrollo.
● Correo Electrónico: Ingrese su dirección de correo electrónico.
● Contraseña: Establezca una contraseña segura de su elección.
● Número de Teléfono: Proporcione su número de teléfono.
● Idioma: Seleccione su idioma preferido.
● País: Indique su país de residencia.
● Datos de Demostración: Decida si desea incluir datos de demostración en su
instalación.
Implementación de Odoo 17 Community Edition en Ambiente
de Producción 📘
Optimización de Odoo para un Entorno de Producción Seguro y Eficiente 🛡
La implementación de Odoo 17 Community Edition en un ambiente de producción no
es solo una mejora, es una necesidad para cualquier empresa que busca escalar sus
operaciones y garantizar la seguridad de sus datos. Un ambiente de producción
ofrece la estabilidad, seguridad y capacidad de integración que los ambientes de
desarrollo y pruebas simplemente no pueden proporcionar.
Configuración de Nginx y SSL para Acceso Seguro:

● Nginx: Actúa como un servidor web de alto rendimiento que facilita el acceso
seguro a tu instalación de Odoo.
● Certificado SSL: Proporciona una conexión cifrada entre el servidor y los
clientes, asegurando que los datos sensibles estén protegidos.
● Renovación Automática de SSL: Mantiene la seguridad sin interrupciones al
renovar automáticamente los certificados antes de que expiren.
● Modo Proxy: Mejora la seguridad y permite una configuración más avanzada
del servidor web.
Mejoras de Seguridad y Rendimiento:

● Interfaz de Enlace: Cambiar la interfaz de enlace a local mejora la seguridad al

restringir el acceso directo al puerto 8069, utilizado por Odoo.
● Múltiples Procesos de Trabajo (Workers): Aumenta la capacidad de manejar
múltiples usuarios simultáneamente, distribuyendo la carga y mejorando la
respuesta del sistema.
Razones para Usar un Ambiente de Producción:

● Estabilidad: Un ambiente de producción está optimizado para manejar cargas

de trabajo reales y usuarios concurrentes sin comprometer el rendimiento.
● Seguridad Mejorada: Las configuraciones de seguridad están diseñadas para
proteger contra amenazas en tiempo real.
● Integración Completa: Asegura la integración con otros sistemas
empresariales y bases de datos en vivo, lo cual es esencial para operaciones
diarias.
● Soporte Continuo: Ofrece soporte y mantenimiento continuos para resolver
rápidamente cualquier problema que pueda surgir.
Pasos para Configurar Odoo en Producción:

1. Configurar Nginx: Instala y configura Nginx para manejar el tráfico web y

proporcionar acceso seguro a través de SSL.
 2. DNS y SSL: Configura los registros de DNS para apuntar tu nombre de
dominio a la dirección IP del servidor de Ubuntu y obtén un certificado SSL
gratuito.
3. Modo Proxy en Odoo: Cambia el archivo de configuración de Odoo para
utilizar el modo proxy, mejorando así la seguridad y el rendimiento.
4. Habilitar Múltiples Workers: Configura Odoo para ejecutarse con múltiples
workers, lo que permite un mejor manejo de múltiples usuarios y sesiones
simultáneas.
¡Prepárate para experimentar la verdadera potencia y seguridad de Odoo 17 en un
ambiente de producción! Con estos pasos, tu empresa estará lista para enfrentar los
desafíos del mundo empresarial moderno con confianza y eficiencia.