Paso 1: Iniciar sesión en el servidor Ubuntu
Antes de comenzar la instalación, asegúrate de haber iniciado sesión en tu servidor Ubuntu 24.04. Si trabajas en una máquina remota, conéctate mediante SSH. Si tienes acceso directo, puedes iniciar sesión localmente desde el propio servidor.
Dependiendo de tu entorno, existen varias formas de acceder a tu servidor Ubuntu 24.04. A continuación se muestran tres métodos de uso común:
1. Inicio de sesión con nombre de usuario y dirección IP (puerto predeterminado)
Si tu servidor está configurado con el puerto SSH estándar (22) y no requiere ninguna autenticación personalizada, puedes conectarte con:
ssh username@server_ip
username : el nombre de usuario de tu servidor.
server_ip : la dirección IP asignada a tu servidor.
2. Inicio de sesión con un puerto específico
Si tu servidor está configurado con un puerto SSH distinto del predeterminado (22), deberás incluir el número de puerto en el comando de conexión:
ssh -p port_number username@server_ip
port_number: el puerto SSH configurado en tu servidor.
username: el nombre de usuario de tu servidor.
server_ip: la dirección IP asignada a tu servidor.
3. Inicio de sesión con una llave PEM
Si tu servidor está configurado para requerir una llave PEM como autenticación, conéctate usando el siguiente comando:
ssh -i /path/to/your/key.pem username@server_ip
/path/to/your/key.pem: Especifica la ruta completa donde se encuentra almacenado tu archivo de llave PEM.
username: El nombre de usuario que utilizas para tu servidor.
server_ip: La dirección IP asignada a tu servidor.
Selecciona el método de inicio de sesión que corresponda a tu configuración. Una vez conectado, puedes continuar con el proceso de instalación de Odoo 19.
Paso 2: Actualizar el servidor
Antes de instalar Odoo 19, asegúrate de que tu servidor Ubuntu 24.04 esté completamente actualizado. Mantener el sistema al día garantiza que cuentes con los últimos parches de seguridad y mejoras de software.
El siguiente comando actualiza el índice de paquetes de tu sistema, para que Ubuntu conozca las versiones más recientes disponibles:
sudo apt-get update
Usa el siguiente comando para actualizar todos los paquetes instalados en tu servidor a sus últimas versiones disponibles:
sudo apt-get upgrade
El proceso de actualización puede tardar un tiempo, dependiendo de cuántos paquetes necesiten actualizarse. Una vez terminado, tu servidor estará al día y listo para los siguientes pasos de la instalación.
Paso 3: Instalar paquetes y librerías
Antes de instalar Odoo 19, necesitas instalar varios paquetes y librerías esenciales para que el sistema funcione correctamente. Sigue estos comandos:
Pip es el gestor de paquetes oficial de Python y es necesario para instalar y administrar librerías de Python. Instálalo con el siguiente comando:
sudo apt-get install -y python3-pip
Odoo requiere varias librerías de desarrollo y dependencias para compilarse y ejecutarse correctamente. Instálalas con el siguiente comando:
sudo apt-get install -y python3-dev libxml2-dev libxslt1-dev zlib1g-dev libsasl2-dev libldap2-dev build-essential libssl-dev libffi-dev libmysqlclient-dev libjpeg-dev libpq-dev libjpeg8-dev liblcms2-dev libblas-dev libatlas-base-dev
Node.js es necesario para ciertas tareas de frontend en Odoo, y NPM es su gestor de paquetes. Instálalos en tu servidor con los siguientes comandos:
sudo apt-get install -y npm
En algunos casos, Node.js se instala con el nombre nodejs, mientras que ciertas aplicaciones esperan el comando node. Para garantizar la compatibilidad, crea un enlace simbólico con el siguiente comando:
sudo ln -s /usr/bin/nodejs /usr/bin/node
Odoo utiliza Less como preprocesador de CSS, y el plugin Clean-CSS ayuda a minificar los archivos CSS para un mejor rendimiento. Instala ambos con el siguiente comando:
sudo npm install -g less less-plugin-clean-css
El paquete node-less integra el preprocesador CSS Less con Node.js, permitiendo que Odoo compile el CSS correctamente. Instálalo usando:
sudo apt-get install -y node-less
Siguiendo estos pasos se instalan todos los paquetes y librerías requeridos para Odoo 19. Una vez completado, tu servidor tendrá todos los requisitos previos listos para la siguiente etapa del proceso de instalación.
Paso 4: Configurar el servidor de base de datos
Odoo 19 utiliza PostgreSQL para gestionar su base de datos. Sigue estos pasos para instalar y configurar PostgreSQL en tu servidor Ubuntu 24.04:
Para configurar el servidor de base de datos PostgreSQL en Ubuntu 24.04, ejecuta el siguiente comando:
sudo apt-get install -y postgresql
PostgreSQL administra las bases de datos bajo su propio usuario del sistema. Cambia a este usuario para crear un usuario de base de datos dedicado para Odoo:
sudo su - postgres
PostgreSQL opera bajo una cuenta de usuario del sistema independiente. Para crear un usuario de base de datos dedicado para Odoo, primero cambia al usuario de PostgreSQL:
createuser --createdb --username postgres --no-createrole --superuser --pwprompt odoo19
createdb: permite al usuario crear nuevas bases de datos.
username postgres: especifica que el superusuario de PostgreSQL ejecutará el comando.
no-createrole: evita que el usuario cree roles adicionales.
superuser: otorga al usuario todos los privilegios de superusuario.
pwprompt: solicita que ingreses una contraseña para el nuevo usuario.
odoo19 : el nombre del nuevo usuario de PostgreSQL que estás creando para Odoo.
Después de crear el usuario de PostgreSQL, vuelve a tu usuario normal del sistema saliendo de la sesión de PostgreSQL:
exit
Paso 5: Crear un usuario del sistema para Odoo
Crear un usuario del sistema independiente para Odoo garantiza que la aplicación tenga los permisos correctos y opere de forma independiente, sin afectar otros procesos del sistema.
Crea un usuario del sistema dedicado para Odoo, incluyendo un directorio home donde residirá la aplicación:
sudo adduser --system --home=/opt/odoo19 --group odoo19
system: crea un usuario del sistema con un UID bajo, adecuado para ejecutar servicios.
home=/opt/odoo19: establece el directorio home del nuevo usuario.
group odoo19: crea un grupo con el mismo nombre y agrega el usuario a él.
Con un usuario del sistema dedicado y la base de datos PostgreSQL listos, Odoo 19 ya cuenta con un entorno seguro para operar. Estás listo para continuar con los pasos de instalación y configuración.
Paso 6: Obtener Odoo 19 Community Edition desde GitHub
Para instalar Odoo 19, comienza clonando su repositorio oficial desde GitHub. Sigue estos pasos:
Git es un sistema de control de versiones necesario para clonar el repositorio de Odoo. Instálalo en tu servidor Ubuntu 24.04 con el siguiente comando:
sudo apt-get install -y git
Inicia sesión como el usuario del sistema dedicado de Odoo que creaste anteriormente. Esto garantiza que todos los archivos de Odoo pertenezcan al usuario correcto y tengan los permisos adecuados:
sudo su - odoo19 -s /bin/bash
Usa Git para clonar el repositorio de Odoo 19 Community Edition. La opción --depth 1 descarga únicamente el último commit, y --branch master asegura que obtengas la versión estable más reciente:
git clone https://www.github.com/odoo/odoo --depth 1 --branch 19.0 --single-branch .
Después de clonar el repositorio de Odoo, vuelve a tu cuenta de usuario normal del sistema saliendo de la sesión del usuario de Odoo:
exit
Con el repositorio de Odoo 19 clonado, ya puedes continuar con la configuración e instalación de la aplicación.
Paso 7: Instalar los paquetes de Python requeridos
Para asegurar que Odoo 19 funcione correctamente, debes crear un entorno virtual de Python e instalar todos los paquetes de Python necesarios junto con dependencias adicionales. Sigue estos pasos:
1. Instalar el paquete de entorno virtual de Python 3: Este paquete te permite crear entornos de Python aislados, garantizando que las librerías de Python de Odoo 19 no interfieran con la instalación de Python del sistema.
sudo apt install -y python3-venv
2. Crear un entorno virtual de Python: Configura un entorno virtual de Python en el directorio home de Odoo (/opt/odoo19/) para mantener sus dependencias aisladas del Python del sistema:
sudo python3 -m venv /opt/odoo19/venv
3. Activar el entorno virtual: Primero, cambia al usuario del sistema de Odoo y luego activa el entorno virtual para instalar las dependencias de Python de Odoo:
sudo -s cd /opt/odoo19/ source venv/bin/activate
4. Instalar las dependencias de Python: Con el entorno virtual activo, usa pip para instalar todos los paquetes de Python necesarios especificados en el archivo requirements.txt de Odoo:
pip install -r requirements.txt
5. Instalar wkhtmltopdf: Odoo usa “wkhtmltopdf” para generar reportes en PDF. Descarga e instala el paquete .deb apropiado para Ubuntu 24.04:
sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb
6. Instalar la dependencia de OpenSSL: Si tu instalación de Odoo 19 requiere soporte SSL, asegúrate de que la librería OpenSSL esté instalada:
sudo wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
7. Instalar fuentes adicionales: Para garantizar el correcto renderizado de los reportes PDF, instala los paquetes de fuentes requeridos por wkhtmltopdf:
sudo apt-get install -y xfonts-75dpi
8. Instalar el paquete wkhtmltopdf: Después de descargar el paquete .deb de wkhtmltopdf, instálalo en tu servidor usando:
sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb
9. Corregir problemas de dependencias: Este comando corrige automáticamente cualquier dependencia faltante que pudo haber surgido durante la instalación del paquete wkhtmltopdf
sudo apt install -f
10. Desactivar el entorno virtual: Después de instalar todos los paquetes y dependencias de Python requeridos, sal del entorno virtual para volver a la shell normal:
deactivate
Seguir estos pasos garantiza que todos los paquetes de Python y dependencias del sistema requeridos estén instalados, preparando tu servidor para la instalación de Odoo 19.
Paso 8: Configurar el archivo de configuración
Para configurar Odoo 19, crea y edita su archivo de configuración. Este archivo contiene los ajustes clave del servidor Odoo, incluyendo la información de conexión a la base de datos, las ubicaciones de los archivos de log y otras opciones del servidor.
1. Copiar el archivo de configuración predeterminado: Copia el archivo de configuración de ejemplo de Odoo al directorio /etc y renómbralo para usarlo con tu instalación de Odoo:
sudo cp /opt/odoo19/debian/odoo.conf /etc/odoo19.conf
2. Editar el archivo de configuración: Abre el archivo de configuración de Odoo en un editor de texto para modificar sus ajustes según la configuración de tu servidor y base de datos:
sudo nano /etc/odoo19.conf
3. Modificar el archivo de configuración: Edita el archivo de configuración de Odoo y actualízalo con los ajustes recomendados. Asegúrate de reemplazar los marcadores de posición con los valores reales de tu servidor y base de datos:
[options] ; This is the password that allows database operations: ; admin_passwd = admin db_host = localhost db_port = 5432 db_user = odoo19 db_password = 123456 addons_path = /opt/odoo19/addons logfile = /var/log/odoo/odoo19.log
db_host: establécelo en localhost si PostgreSQL se ejecuta en el mismo servidor.
db_user: el usuario de PostgreSQL creado específicamente para Odoo.
db_password: la contraseña del usuario de PostgreSQL.
addons_path: ruta completa al directorio de addons de Odoo (p. ej., /opt/odoo19/addons).
logfile: ruta completa al archivo de log de Odoo (p. ej., /var/log/odoo19/odoo.log).
4. Establecer los permisos del archivo: Actualiza el propietario y los permisos del archivo de configuración de Odoo para asegurar que solo el usuario del sistema de Odoo pueda acceder a él:
sudo chown odoo19: /etc/odoo19.conf sudo chmod 640 /etc/odoo19.conf
5. Crear un directorio de logs: Crea un directorio dedicado para los logs de Odoo y asigna el propietario y los permisos correctos para que el usuario del sistema de Odoo pueda escribir archivos de log:
sudo mkdir /var/log/odoo sudo chown odoo19:root /var/log/odoo
Siguiendo estos pasos, has configurado Odoo 19 con los ajustes necesarios. Ya estás listo para iniciar el servicio de Odoo y continuar con configuraciones adicionales.
Para administrar Odoo 19 como un servicio en tu servidor Ubuntu 24.04, crea un archivo de servicio de systemd. Esto te permitirá iniciar, detener y habilitar Odoo para que se ejecute automáticamente al arrancar el sistema.
Crear el archivo de servicio: Abre un nuevo archivo de servicio de systemd para definir el servicio de Odoo 19:
sudo nano /etc/systemd/system/odoo19.service
Agregar la configuración del servicio: Pega el siguiente contenido en el archivo odoo19.service. Esta configuración define cómo se ejecutará el servicio de Odoo 19 en tu servidor:
[Unit] Description=Odoo19 Documentation=http://www.odoo.com [Service] # Ubuntu/Debian convention: Type=simple User=odoo19 ExecStart=/opt/odoo19/venv/bin/python3.12 /opt/odoo19/odoo-bin -c /etc/odoo19.conf [Install] WantedBy=default.target
Type=simple: ejecuta el servicio en primer plano.
User=odoo19: ejecuta el servicio como el usuario del sistema dedicado de Odoo.
ExecStart: el comando utilizado para iniciar Odoo, que especifica el ejecutable de Odoo y su archivo de configuración.
Establecer los permisos del archivo de servicio: Establece el propietario y los permisos correctos en el archivo de servicio systemd de Odoo para evitar modificaciones no autorizadas:
sudo chmod 755 /etc/systemd/system/odoo19.service sudo chown root: /etc/systemd/system/odoo19.service
Iniciar el servicio de Odoo: Inicia el servicio de Odoo 19 usando systemctl para lanzarlo de inmediato:
sudo systemctl start odoo19.service
Acceder a Odoo desde tu navegador: Abre tu navegador web y ve a la siguiente dirección para acceder a tu instancia de Odoo 19:
http://<your_domain_or_IP_address>:8069
Reemplaza con el nombre de dominio o la dirección IP real de tu servidor. Odoo 19 usa el puerto 8069 por defecto, así que inclúyelo en la URL a menos que hayas configurado un puerto diferente.
Monitorear el log de Odoo: Para ver en tiempo real la salida del log de Odoo 19 y revisar errores o actualizaciones de estado, usa el comando tail:
sudo tail -f /var/log/odoo/odoo19.log
Habilitar el servicio de Odoo al arrancar: Configura el servicio de Odoo 19 para que se inicie automáticamente al arrancar el sistema:
sudo systemctl enable odoo19.service
Reiniciar el servicio de Odoo: Si realizas cambios en la configuración o en los ajustes del sistema, reinicia el servicio de Odoo 19 para aplicarlos
sudo systemctl restart odoo19.service
Siguiendo estos pasos, Odoo 19 ya debería estar en ejecución en tu servidor Ubuntu 24.04. Puedes acceder a él desde tu navegador web, y el servicio está configurado para iniciarse automáticamente cada vez que el servidor arranque.