Instalación de Odoo en VPS

Configuración

Ahora que todos los componentes están instalados, es necesario configurarlos correctamente para que funcionen juntos. Configuraremos Odoo, Nginx y obtendremos certificados SSL de Let's Encrypt.

1. Configuración de Odoo

Crearemos un archivo de configuración para Odoo. Es importante almacenar la contraseña maestra y otros datos sensibles en este archivo, pero no hacerlo público.

sudo nano /etc/odoo/odoo.conf

Agregue el siguiente contenido. Reemplace your_master_password por una contraseña fuerte y compleja. Recuérdela, la necesitará para administrar las bases de datos de Odoo a través de la interfaz web.

[options]
; Esta es la contraseña maestra para administrar las bases de datos de Odoo (creación, eliminación, copia de seguridad)
; ¡Use una contraseña compleja y única!
admin_passwd = your_master_password
db_host = False
db_port = False
db_user = odoo
db_password = False
addons_path = /opt/odoo/odoo17/addons
xmlrpc_port = 8069
longpolling_port = 8072
logfile = /var/log/odoo/odoo.log
logrotate = True
limit_time_cpu = 600
limit_time_real = 1200
workers = 0 ; Establezca 0 para depuración, >0 para producción (2 * CPU_cores + 1)
max_cron_threads = 1

Nota sobre workers: Para producción, se recomienda establecer workers en (2 * CPU_cores) + 1. Por ejemplo, para un VPS de 4 núcleos, esto sería (2 * 4) + 1 = 9. Establecer workers = 0 inicia Odoo en modo de depuración con un solo hilo, lo cual es conveniente para la configuración inicial, pero no adecuado para producción.

Cree el directorio para los logs y establezca los permisos correctos:

sudo mkdir /var/log/odoo
sudo chown odoo:odoo /var/log/odoo

2. Creación del servicio de sistema Odoo

Crearemos un archivo de unidad Systemd para gestionar Odoo como un servicio.

sudo nano /etc/systemd/system/odoo.service

Agregue el siguiente contenido:

[Unit]
Description=Odoo ERP Management Software
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
User=odoo
Group=odoo
ExecStart=/opt/odoo/odoo17-venv/bin/python3 /opt/odoo/odoo17/odoo-bin -c /etc/odoo/odoo.conf
WorkingDirectory=/opt/odoo/odoo17
StandardOutput=journal+console
StandardError=journal+console
Restart=always
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Guarde el archivo y recargue Systemd, luego inicie y habilite el servicio Odoo:

sudo systemctl daemon-reload # Recargar la configuración de Systemd
sudo systemctl start odoo # Iniciar el servicio Odoo
sudo systemctl enable odoo # Habilitar el inicio automático del servicio Odoo
sudo systemctl status odoo # Verificar el estado de Odoo

Debería ver el estado active (running). Odoo ahora escucha en el puerto 8069.

3. Configuración de Nginx como proxy inverso

Crearemos un archivo de configuración de Nginx para su dominio. Reemplace your_domain.com con su dominio real.

sudo nano /etc/nginx/conf.d/odoo.conf # Uso de conf.d para un archivo separado

Agregue el siguiente contenido. Esta es una configuración básica para el proxy de tráfico de Odoo con soporte para WebSocket.

upstream odoo {
    server 127.0.0.1:8069; # Puerto de Odoo
}

upstream odoo_longpolling {
    server 127.0.0.1:8072; # Puerto de Odoo Longpolling
}

server {
    listen 80;
    server_name your_domain.com www.your_domain.com; # Reemplace con su dominio

    # Redirección de HTTP a HTTPS (será configurado por Certbot)
    # return 301 https://$host$request_uri;
}

# Servidor para HTTPS (por ahora comentado, será completado por Certbot)
# server {
#     listen 443 ssl;
#     server_name your_domain.com www.your_domain.com;
#
#     ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
#     ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
#     ssl_protocols TLSv1.2 TLSv1.3;
#     ssl_prefer_server_ciphers on;
#     ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384';
#     ssl_session_cache shared:SSL:10m;
#     ssl_session_timeout 10m;
#
#     proxy_read_timeout 720s;
#     proxy_connect_timeout 720s;
#     proxy_send_timeout 720s;
#
#     # Odoo Longpolling
#     location /longpolling {
#         proxy_pass http://odoo_longpolling;
#         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#         proxy_set_header X-Real-IP $remote_addr;
#         proxy_set_header Host $host;
#         proxy_set_header X-Forwarded-Proto $scheme;
#         proxy_http_version 1.1;
#         proxy_set_header Upgrade $http_upgrade;
#         proxy_set_header Connection "upgrade";
#     }
#
#     # Odoo Web
#     location / {
#         proxy_pass http://odoo;
#         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#         proxy_set_header X-Real-IP $remote_addr;
#         proxy_set_header Host $host;
#         proxy_set_header X-Forwarded-Proto $scheme;
#     }
#
#     # Archivos estáticos (se puede configurar el almacenamiento en caché)
#     location ~* /web/static/ {
#         proxy_cache_valid 200 60m;
#         proxy_buffering on;
#         expires 864000;
#         proxy_pass http://odoo;
#     }
#
#     gzip_static on;
# }

Guarde el archivo. Verifique la configuración de Nginx y reinícielo:

sudo nginx -t # Verificación de la sintaxis de Nginx
sudo systemctl restart nginx # Reinicio de Nginx

Elimine la configuración predeterminada de Nginx para evitar conflictos:

sudo rm /etc/nginx/sites-enabled/default
sudo systemctl reload nginx

En este punto, Odoo debería ser accesible a través de su dominio por HTTP (puerto 80).

4. Configuración de TLS/HTTPS a través de Let's Encrypt con Certbot

Instalaremos Certbot, que configurará automáticamente Nginx para usar certificados SSL de Let's Encrypt.

sudo apt install certbot python3-certbot-nginx -y # Instalación de Certbot y el plugin para Nginx

Ejecute Certbot. Escaneará su configuración de Nginx y le ofrecerá dominios para obtener un certificado.

sudo certbot --nginx -d your_domain.com -d www.your_domain.com # Reemplace con su dominio

Siga las instrucciones: ingrese su dirección de correo electrónico, acepte los términos de servicio y elija si desea redirigir el tráfico HTTP a HTTPS (recomendado). Certbot modificará automáticamente su archivo /etc/nginx/conf.d/odoo.conf, agregando la configuración necesaria para SSL y la redirección.

Verifique que la renovación automática de certificados funcione:

sudo certbot renew --dry-run # Renovación de prueba de certificados

Si el comando se completa sin errores, la renovación automática funcionará a través de la tarea cron de Certbot.

5. Verificación de la operatividad

Abra su dominio (https://your_domain.com) en un navegador web. Debería ver la página de instalación de Odoo solicitando la creación de una nueva base de datos. Asegúrese de que la conexión sea segura (candado verde en la barra de direcciones).

También puede verificar la disponibilidad de Odoo y Nginx usando curl:

curl -I https://your_domain.com # Verificación de encabezados HTTP
curl http://127.0.0.1:8069 # Verificación de acceso directo a Odoo

En el primer caso, debería ver los encabezados de Nginx e información sobre HTTPS. En el segundo, los encabezados de Odoo.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares son una parte fundamental de la operación de cualquier servicio en producción. Odoo almacena sus datos en una base de datos PostgreSQL y tiene algunos archivos en disco. Configuraremos un script sencillo para realizar copias de seguridad automáticas.

1. Qué respaldar

• Base de datos PostgreSQL: Contiene todos los datos de negocio de Odoo. Es el componente más importante.
• Archivos de configuración de Odoo: /etc/odoo/odoo.conf y /etc/systemd/system/odoo.service.
• Módulos personalizados y adjuntos: Si utiliza sus propios módulos, estos suelen encontrarse en /opt/odoo/odoo17/addons o en un directorio separado. Los adjuntos (archivos subidos por los usuarios) se almacenan en el directorio filestore dentro del directorio de datos de Odoo (por defecto /opt/odoo/.local/share/Odoo/filestore/).
• Configuración de Nginx: /etc/nginx/conf.d/odoo.conf.
• Certificados Let's Encrypt: Aunque se renuevan automáticamente, tener una copia no está de más (/etc/letsencrypt/).

2. Script sencillo de copia de seguridad automática

Crearemos un script que realizará un volcado de la base de datos y archivará los archivos importantes.

sudo mkdir -p /opt/odoo/backups
sudo chown odoo:odoo /opt/odoo/backups
sudo nano /opt/odoo/backup_script.sh

Añada el siguiente contenido. Reemplace your_odoo_db_name por el nombre de su base de datos Odoo (lo verá al crear la BD en la interfaz web).

#!/bin/bash

# Directorio para copias de seguridad
BACKUP_DIR="/opt/odoo/backups"
DATE=$(date +%Y%m%d_%H%M%S)
DB_NAME="your_odoo_db_name" # Nombre de su base de datos Odoo
ODOO_CONF="/etc/odoo/odoo.conf"
ODOO_SERVICE="/etc/systemd/system/odoo.service"
NGINX_CONF="/etc/nginx/conf.d/odoo.conf"
LETSENCRYPT_DIR="/etc/letsencrypt"
ODOO_HOME="/opt/odoo"
ODOO_FILENAMES_DIR="/opt/odoo/.local/share/Odoo/filestore/${DB_NAME}" # Ruta al filestore de Odoo

# Creación del directorio para la copia de seguridad actual
CURRENT_BACKUP_DIR="${BACKUP_DIR}/odoo_backup_${DATE}"
mkdir -p "$CURRENT_BACKUP_DIR"

echo "Iniciando la copia de seguridad de Odoo..."

# 1. Copia de seguridad de la base de datos PostgreSQL
echo "Volcado de la base de datos PostgreSQL..."
sudo -u postgres pg_dump "$DB_NAME" > "${CURRENT_BACKUP_DIR}/${DB_NAME}.sql"
if [ $? -eq 0 ]; then
    echo "Volcado de la base de datos creado con éxito."
else
    echo "Error al crear el volcado de la base de datos."
    exit 1
fi

# 2. Copia de archivos de configuración
echo "Copiando archivos de configuración..."
cp "$ODOO_CONF" "$CURRENT_BACKUP_DIR/"
cp "$ODOO_SERVICE" "$CURRENT_BACKUP_DIR/"
cp "$NGINX_CONF" "$CURRENT_BACKUP_DIR/"

# 3. Copia del directorio de adjuntos (filestore)
if [ -d "$ODOO_FILENAMES_DIR" ]; then
    echo "Copiando el directorio de adjuntos (filestore)..."
    cp -R "$ODOO_FILENAMES_DIR" "$CURRENT_BACKUP_DIR/"
else
    echo "Directorio de adjuntos no encontrado: $ODOO_FILENAMES_DIR. Omitiendo."
fi

# 4. Copia de módulos personalizados (si están en un directorio separado)
# Ejemplo: si tiene módulos personalizados en /opt/odoo/custom_addons
# if [ -d "/opt/odoo/custom_addons" ]; then
#     echo "Copiando módulos personalizados..."
#     cp -R /opt/odoo/custom_addons "$CURRENT_BACKUP_DIR/"
# else
#     echo "Directorio de módulos personalizados no encontrado. Omitiendo."
# fi

# 5. Archivado de toda la copia de seguridad
echo "Archivando la copia de seguridad..."
tar -czf "${BACKUP_DIR}/odoo_backup_${DATE}.tar.gz" -C "$CURRENT_BACKUP_DIR" .
if [ $? -eq 0 ]; then
    echo "Copia de seguridad archivada con éxito: ${BACKUP_DIR}/odoo_backup_${DATE}.tar.gz"
    rm -rf "$CURRENT_BACKUP_DIR" # Eliminando directorio temporal
else
    echo "Error al archivar la copia de seguridad."
    exit 1
fi

# 6. Eliminación de copias de seguridad antiguas (por ejemplo, mantener las últimas 7 días)
echo "Eliminando copias de seguridad antiguas (más de 7 días)..."
find "$BACKUP_DIR" -type f -name "*.tar.gz" -mtime +7 -delete
echo "Copia de seguridad completada."

Haga el script ejecutable:

sudo chmod +x /opt/odoo/backup_script.sh

Verifique el funcionamiento del script ejecutándolo manualmente:

sudo /opt/odoo/backup_script.sh

Asegúrese de que ha aparecido un archivo en /opt/odoo/backups.

3. Configuración de Cron para el inicio automático

Añadiremos el script al programador de tareas Cron para que se ejecute automáticamente, por ejemplo, cada día a las 03:00 de la mañana.

sudo crontab -e

Si le pide un editor, elija nano. Añada la siguiente línea al final del archivo:

0 3 * * * /opt/odoo/backup_script.sh > /dev/null 2>&1

Esta línea significa: "Cada día a las 3 horas y 0 minutos, ejecutar el script y redirigir la salida a /dev/null".

4. Dónde almacenar (S3 externo / VPS separado)

Almacenar las copias de seguridad en el mismo servidor que el servicio principal es extremadamente arriesgado. Si el servidor falla o es comprometido, perderá tanto los datos como las copias de seguridad. Se recomienda utilizar almacenamiento externo:

• Almacenamiento compatible con S3: Servicios en la nube como Amazon S3, DigitalOcean Spaces, Backblaze B2, o MinIO en otro servidor. Para ello, puede integrar s3cmd o rclone en su script de copia de seguridad.
• VPS separado: Puede alquilar un VPS pequeño y económico y usar rsync o scp para sincronizar regularmente las copias de seguridad con él.
• Recurso compartido NFS o almacenamiento en red: Si tiene su propia infraestructura, puede montar una unidad de red.

Ejemplo de cómo añadir rclone para almacenamiento S3 (requiere configuración previa de rclone config):

# Añada a su script backup_script.sh después de la archivación
echo "Subiendo la copia de seguridad a S3..."
/usr/bin/rclone copy "${BACKUP_DIR}/odoo_backup_${DATE}.tar.gz" "your_s3_remote_name:your_s3_bucket_name/"
if [ $? -eq 0 ]; then
    echo "Copia de seguridad subida a S3 con éxito."
else
    echo "Error al subir la copia de seguridad a S3."
fi

5. Actualizaciones: rolling vs maintenance window

Odoo, como cualquier sistema complejo, requiere actualizaciones regulares. Existen dos enfoques principales:

• Actualizaciones continuas (rolling updates): Se aplican a componentes individuales sin un tiempo de inactividad completo del sistema. Para Odoo, esto puede ser una actualización de módulos o pequeñas correcciones. Requiere una arquitectura cuidadosamente planificada (por ejemplo, un clúster de varias instancias de Odoo) y no siempre es aplicable a actualizaciones mayores.
• Ventana de mantenimiento (maintenance window): Un período de inactividad planificado del sistema para realizar actualizaciones mayores (por ejemplo, de Odoo 17 a Odoo 18), actualizaciones del SO, PostgreSQL, etc. Este es el enfoque más común y seguro para un VPS individual.

Para Odoo en un VPS, se recomienda utilizar el enfoque de ventana de mantenimiento. Planifique las actualizaciones durante los períodos de menor actividad, creando previamente una copia de seguridad completa. El proceso de actualización de Odoo entre versiones mayores puede ser complejo y a menudo requiere una migración de la base de datos, por lo que siempre pruebe las actualizaciones en una copia del sistema de producción.

Para actualizar las dependencias de Python de Odoo:

sudo systemctl stop odoo
sudo su - odoo -s /bin/bash
cd /opt/odoo/odoo17
/opt/odoo/odoo17-venv/bin/pip install --upgrade -r requirements.txt
exit
sudo systemctl start odoo

Para actualizar Odoo mismo (si lo clonó desde git):

sudo systemctl stop odoo
sudo su - odoo -s /bin/bash
cd /opt/odoo/odoo17
git pull origin 17.0 # O su otra rama
exit
sudo systemctl start odoo

Siempre lea atentamente el changelog de Odoo antes de actualizar y pruebe en un entorno de staging.

Solución de problemas + Preguntas frecuentes

Esta sección recopila problemas y preguntas comunes que pueden surgir durante la instalación y operación de Odoo en un VPS.

Odoo no se inicia o muestra un error 500/502 en el navegador. ¿Qué debo verificar?

En primer lugar, revise los logs de Odoo: sudo journalctl -u odoo.service o sudo tail -f /var/log/odoo/odoo.log. Busque mensajes de error. Las causas frecuentes incluyen: ruta incorrecta al intérprete de Python, dependencias faltantes, problemas de conexión a PostgreSQL (usuario/contraseña incorrectos, PostgreSQL no iniciado), errores de sintaxis en odoo.conf. También verifique el estado del servicio Odoo: sudo systemctl status odoo.

Nginx muestra un error 502 Bad Gateway.

Esto significa que Nginx no puede conectarse con el backend de Odoo. Asegúrese de que el servicio Odoo esté en ejecución y escuchando en el puerto 8069 (sudo systemctl status odoo, sudo ss -tulpn | grep 8069). Verifique la configuración de Nginx en busca de errores tipográficos en proxy_pass. También revise los logs de Nginx: sudo tail -f /var/log/nginx/error.log.

No puedo obtener un certificado SSL de Let's Encrypt.

Asegúrese de que su dominio apunte correctamente a la dirección IP de su VPS (verifique el registro A en el DNS). Asegúrese de que los puertos 80 y 443 estén abiertos en su firewall (sudo ufw status). Desactive temporalmente Nginx o asegúrese de que Certbot pueda usarlo para la verificación del dominio. Revise los logs de Certbot, si están disponibles.

Odoo funciona muy lento. ¿Cómo optimizarlo?

Verifique cuánta memoria RAM está disponible (free -h). Odoo puede ser exigente con la RAM. Aumente el número de workers en odoo.conf (workers = (2 * CPU_cores) + 1) y reinicie Odoo. Asegúrese de que el disco sea SSD o NVMe. Considere la optimización de PostgreSQL (configuración de postgresql.conf, por ejemplo, shared_buffers, work_mem). Asegúrese de que Odoo no se esté ejecutando en modo de depuración (flag --dev o workers=0).

¿Qué configuración mínima de VPS es adecuada?

Para uno o dos usuarios con módulos básicos de Odoo, los requisitos mínimos son 1 vCPU, 2 GB de RAM y 40 GB de SSD. Sin embargo, para un funcionamiento más cómodo y la posibilidad de crecimiento, se recomienda empezar con 2 vCPU, 4 GB de RAM y 80 GB de SSD NVMe. Esto proporcionará una mejor respuesta del sistema y margen para futuras expansiones.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de las pequeñas y medianas empresas, un VPS es la opción óptima, ofreciendo un buen equilibrio entre costo, rendimiento y flexibilidad. Los servidores dedicados se vuelven necesarios para cargas muy altas (cientos de usuarios activos), requisitos estrictos de rendimiento garantizado sin "vecinos", la necesidad de hardware específico (por ejemplo, arreglos RAID) o grandes volúmenes de datos. Si recién está comenzando con Odoo o su equipo no supera los 50-70 usuarios, un VPS probablemente será más que suficiente.

Quiero instalar módulos personalizados de Odoo. ¿Dónde debo colocarlos?

Cree un directorio separado para los módulos personalizados, por ejemplo, /opt/odoo/custom_addons. Asegúrese de que el usuario odoo tenga acceso a él. Luego, añada este directorio al parámetro addons_path en /etc/odoo/odoo.conf, separando las rutas con comas: addons_path = /opt/odoo/odoo17/addons,/opt/odoo/custom_addons. Después de esto, reinicie Odoo y actualice la lista de aplicaciones en la interfaz web.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado Odoo con éxito en su servidor VPS, asegurando su funcionamiento, seguridad con HTTPS y una copia de seguridad fiable. Ahora tiene una potente plataforma para gestionar todos los aspectos de su negocio, completamente bajo su control.

Aquí hay algunos pasos prácticos para seguir adelante:

• Importación de datos y configuración de Odoo: Comience creando una base de datos en la interfaz web de Odoo, luego importe los datos existentes (clientes, productos, pedidos) y configure los módulos principales de acuerdo con sus procesos de negocio.
• Monitorización del rendimiento: Instale herramientas de monitorización (por ejemplo, Prometheus + Grafana o Netdata) para rastrear el uso de CPU, RAM, disco y tráfico de red. Esto le ayudará a identificar "cuellos de botella" y planificar la escalabilidad.
• Optimización del rendimiento de PostgreSQL: Para bases de datos grandes y alta carga, estudie los parámetros de postgresql.conf, como shared_buffers, work_mem, effective_cache_size, para ajustar finamente el rendimiento de la base de datos a sus necesidades.
• Escalado horizontal: Si un solo VPS no es suficiente, considere la posibilidad de separar los componentes: un VPS separado para la base de datos PostgreSQL, varias instancias de Odoo detrás de un balanceador de carga (Nginx o Haproxy).
• Desarrollo de módulos personalizados: Estudie la documentación de Odoo sobre el desarrollo de módulos para adaptar el sistema a los requisitos únicos de su negocio o integrarlo con otros sistemas.