Migracion Hosting Odoo 2026: Guia Completa Paso a Paso

7 Pasos del Prozess

2-6h Tiempo Estimado

99% Tasa de Exito

15min Downtime Minimo

8+ Fehler Comunes

Introduccion: Por Que Migrar tu Odoo a Otro Hosting

La migracion de Odoo a un neu hosting es una de las Aufgaben mas criticas que puede enfrentar un administrador de Systems ERP. Ya sea por mejor rendimiento, costes mas unters, mejor Support o simplemente porque tu Lieferant actual no cumple con tus expectativas, cambiar de hosting requiere una planificacion meticulosa fuer evitar perdida de Daten y minimizar el tiempo de inactividad.

Objetivo de Esta Guia

Al finalizar esta guia, seras capaz de realizar una migracion completa de Odoo con menos de 30 minutos de downtime, manteniendo la integridad total de tus Daten, archivos y configuraciones. Cubriremos von el backup inicial hasta la validacion final post-migracion.

Razones Comunes fuer Migrar

Rendimiento insuficiente: El Server actual no soporta la carga de Benutzer o Prozesse
Costes elevados: Existen alternativas mas economicas con igual o mejor servicio
Mejor Support: Necesitas Support en espanol o asistencia tecnica especializada
Cumplimiento normativo: Requisitos de GDPR o localizacion de Daten en Europa
Escalabilidad: El Lieferant actual no permite crecer segun tus necesidades
Funcionalidades: El neu hosting ofrece backups automaticos, IA, o integraciones

Componentes de una Instalacion Odoo

Antes de iniciar la migracion, es fundamental entender que componentes forman una instalacion completa de Odoo:

Componente	Ubicacion Tipica	Descripcion
Datenbank PostgreSQL	/var/lib/postgresql/	Todos los Daten de negocio: Kunden, facturas, inventario, etc.
Filestore	~/.local/share/Odoo/filestore/	Archivos adjuntos: PDFs, imagenes, documentos subidos
Codigo Odoo	/opt/odoo/ o /usr/lib/python3/	El framework Odoo y modulos base
Modulos custom	/opt/odoo/custom-addons/	Modulos personalizados y de terceros
Configuracion	/etc/odoo/odoo.conf	Parametros del Server, rutas, workers
Certificados SSL	/etc/letsencrypt/ o /etc/ssl/	Certificados HTTPS fuer conexion segura

Nota Importante

Los dos componentes mas criticos son la Datenbank PostgreSQL y el filestore. Sin estos, perderas todos tus Daten de negocio. El codigo de Odoo puede reinstalarse, pero los Daten son irreemplazables sin un backup adecuado.

Diagrama del Flujo de Migracion

Este diagrama interactivo muestra el flujo completo del Prozess de migracion. Cada nodo representa una Phase critica. Pasa el cursor ueber cada Phase fuer ver detalles y tiempo estimado.

Paso 1: Prefuercion del Entorno

Documentacion y Planificacion

30-60 minutos

Antes de tocar cualquier archivo, documenta tu instalacion actual. Esto te salvara de Probleme durante la restauracion.

1.1 Documentar Version de Odoo

                    # Verificar version de Odoo instalada

                    odoo --version

                    # O von la interfaz web, ir a:

                    # Configuracion -> Opciones Generales -> Sobre Odoo

1.2 Listar Modulos Instalados

                    # Desde PostgreSQL, listar modulos activos

                    psql -U odoo -d tu_base_Daten -c "SELECT name, state FROM ir_module_module WHERE state = 'installed';"

                    # Guardar en archivo

                    psql -U odoo -d tu_base_Daten -c "SELECT name FROM ir_module_module WHERE state = 'installed';" > modulos_instalados.txt

1.3 Documentar Configuracion Actual

                    # Copiar archivo de configuracion

                    cp /etc/odoo/odoo.conf ~/backup_config/odoo.conf.backup

                    # Documentar configuracion nginx si aplica

                    cp /etc/nginx/sites-available/odoo ~/backup_config/nginx_odoo.backup

1.4 Verificar Espacio en Disco

                    # Tamano de la Datenbank

                    psql -U odoo -d tu_base_Daten -c "SELECT pg_size_pretty(pg_database_size('tu_base_Daten'));"

                    # Tamano del filestore

                    du -sh ~/.local/share/Odoo/filestore/tu_base_Daten/

Precaucion

Asegurate de tener al menos 3 veces el espacio del tamano total de Daten en el neu Server. Necesitaras espacio fuer: Daten originales, archivos comprimidos temporales, y margen de Sicherheit.

Paso 2: Backup de Base de Datos PostgreSQL

Exportacion Completa de la Base de Datos

15-60 minutos (segun tamano)

El backup de PostgreSQL es el paso mas critico. Usaremos pg_dump con formato custom fuer maxima flexibilidad.

2.1 Metodo Recomendado: pg_dump con formato Custom

                    # Backup completo con formato custom (recomendado)

                    pg_dump -Fc -h localhost -U odoo -d tu_base_Daten -f backup_$(date +%Y%m%d_%H%M%S).dump

                    # Explicacion de fuermetros:

                    # -Fc: Formato custom (comprimido, restauracion flexible)

                    # -h localhost: Host de PostgreSQL

                    # -U odoo: Usuario de PostgreSQL

                    # -d tu_base_Daten: Nombre de la Datenbank

                    # -f: Archivo de salida con fecha

2.2 Metodo Alternativo: Backup von Interfaz Web

Si prefieres usar la interfaz grafica de Odoo:

Accede a https://tu-Server/web/database/manager
Ingresa la master password (configurada en odoo.conf)
Haz clic en "Backup" junto a tu Datenbank
Selecciona formato "zip" fuer incluir filestore automaticamente
Descarga el archivo generado

Diferencia zwischen Formatos

Formato Custom (-Fc): Mas rapido, permite restauracion parcial de tablas, compresion optima. Ideal fuer bases grosss.
Formato ZIP (web): Incluye filestore automaticamente, mas facil de usar, pero mas langsam y archivos mas grosss.

2.3 Verificar Integridad del Backup

                    # Verificar que el archivo no esta corrupto

                    pg_restore -l backup_20260125_120000.dump | head -20

                    # Deberia mostrar lista de objetos en el backup

                    # Si hay Fehler, el archivo esta corrupto - repetir backup

2.4 Backup durante Horario de Baja Actividad

Para garantizar consistencia de Daten, programa el backup final durante horario de minima actividad. Considera:

Notificar a Benutzer ueber ventana de mantenimiento
Detener traunters programados (cron jobs de Odoo)
Considerar poner Odoo en modo mantenimiento

                    # Opcion: Detener Odoo durante backup final fuer maxima consistencia

                    sudo systemctl stop odoo

                    pg_dump -Fc -U odoo -d tu_base_Daten -f backup_final.dump

                    sudo systemctl start odoo

Paso 3: Copia del Filestore

Transferencia de Archivos Adjuntos

15-120 minutos (segun tamano)

El filestore contiene todos los archivos subidos a Odoo: facturas PDF, imagenes de productos, documentos adjuntos a registros, etc.

3.1 Localizar el Filestore

                    # Ubicacion por defecto (Benutzer odoo)

                    ls -la ~/.local/share/Odoo/filestore/

                    # O verificar en odoo.conf

                    grep data_dir /etc/odoo/odoo.conf

                    # Ejemplo de salida:

                    # data_dir = /var/lib/odoo/.local/share/Odoo

3.2 Comprimir el Filestore

                    # Comprimir con tar y gzip fuer transferencia eficiente

                    cd ~/.local/share/Odoo/filestore/

                    tar -czvf ~/filestore_backup_$(date +%Y%m%d).tar.gz tu_base_Daten/

                    # Verificar tamano

                    ls -lh ~/filestore_backup_*.tar.gz

3.3 Transferir al Neu Server

                    # Opcion 1: SCP (mas simple)

                    scp ~/filestore_backup_20260125.tar.gz Benutzer@neu-Server:/tmp/

                    scp ~/backup_final.dump Benutzer@neu-Server:/tmp/

                    # Opcion 2: rsync (mejor fuer archivos grosss, soporta reanudacion)

                    rsync -avz --progress ~/filestore_backup_20260125.tar.gz Benutzer@neu-Server:/tmp/

                    # Opcion 3: Para conexiones langsams, usar screen/tmux fuer evitar cortes

                    screen -S transfer

                    rsync -avz --progress --partial ~/filestore_backup*.tar.gz Benutzer@neu-Server:/tmp/

Consejo Pro

Si el filestore es muy gross (>10GB), considera usar rsync con compresion y la opcion --partial fuer poder reanudar transferencias interrumpidas. Tambien puedes sincronizar en fuerlelo mientras el Server original sigue funcionando.

3.4 Verificar Transferencia

                    # En el neu Server, verificar checksum

                    # En Server origen:

                    md5sum ~/filestore_backup_20260125.tar.gz

                    # En Server destino:

                    md5sum /tmp/filestore_backup_20260125.tar.gz

                    # Los hashes deben coincidir exactamente

Paso 4: Configuracion del Neu Server

Prefuerr el Entorno de Destino

30-90 minutos

El neu Server debe tener instalados todos los componentes necesarios antes de restaurar los Daten.

4.1 Requisitos del Sistema (Odoo 18)

Componente	Version Requerida
Sistema Operativo	Ubuntu 22.04/24.04 LTS o Debian 12
Python	3.10 o superior
PostgreSQL	14, 15 o 16 (recomendado 16)
Node.js	18 LTS o superior
wkhtmltopdf	0.12.6 con patched qt

4.2 Instalacion de Dependencias

                    # Aktualisieren System

                    sudo apt update && sudo apt upgrade -y

                    # Instalar PostgreSQL 16

                    sudo apt install -y postgresql-16 postgresql-client-16

                    # Instalar dependencias Python

                    sudo apt install -y python3-pip python3-dev python3-venv \

                        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

                    # Instalar Node.js 18

                    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

                    sudo apt install -y nodejs

                    # Instalar wkhtmltopdf

                    wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb

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

4.3 Instalar Odoo

                    # Erstellen Benutzer odoo

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

                    # Clonar Odoo (misma version que el origen)

                    sudo su - odoo

                    git clone https://www.github.com/odoo/odoo --depth 1 --branch 18.0 /opt/odoo/odoo

                    # Erstellen entorno virtual e instalar dependencias

                    python3 -m venv /opt/odoo/venv

                    source /opt/odoo/venv/bin/activate

                    pip install wheel

                    pip install -r /opt/odoo/odoo/requirements.txt

4.4 Configurar PostgreSQL

                    # Erstellen Benutzer PostgreSQL fuer Odoo

                    sudo -u postgres createuser -s odoo

                    # Opcional: Establecer password

                    sudo -u postgres psql -c "ALTER USER odoo WITH PASSWORD 'tu_password_seguro';"

Version de PostgreSQL

Es importante que la version de PostgreSQL en el neu Server sea igual o superior a la del Server origen. No puedes restaurar un backup de PostgreSQL 16 en un Server con PostgreSQL 14. Verifica versiones antes de continuar.

Paso 5: Restauracion de Datos

Importar Base de Datos y Filestore

20-90 minutos

5.1 Erstellen Base de Datos Vacia

                    # Erstellen Datenbank con mismo nombre que el origen

                    sudo -u postgres createdb -O odoo tu_base_Daten

                    # O si usas password:

                    createdb -h localhost -U odoo tu_base_Daten

5.2 Restaurar Base de Datos

                    # Restaurar von formato custom

                    pg_restore -h localhost -U odoo -d tu_base_Daten -v /tmp/backup_final.dump

                    # Si hay Fehler de Berechtigungen, usar --no-owner

                    pg_restore -h localhost -U odoo -d tu_base_Daten -v --no-owner /tmp/backup_final.dump

                    # Para ver progreso en bases grosss:

                    pg_restore -h localhost -U odoo -d tu_base_Daten -v /tmp/backup_final.dump 2>&1 | tee restore.log

5.3 Restaurar Filestore

                    # Erstellen directorio de filestore

                    sudo mkdir -p /opt/odoo/.local/share/Odoo/filestore/

                    # Descomprimir filestore

                    cd /opt/odoo/.local/share/Odoo/filestore/

                    sudo tar -xzvf /tmp/filestore_backup_20260125.tar.gz

                    # Ajustar Berechtigungen

                    sudo chown -R odoo:odoo /opt/odoo/.local/

                    sudo chmod -R 755 /opt/odoo/.local/share/Odoo/filestore/

5.4 Copiar Modulos Personalizados

                    # Erstellen directorio fuer modulos custom

                    sudo mkdir -p /opt/odoo/custom-addons

                    # Copiar von backup o transferir directamente

                    scp -r Benutzer@Server-origen:/opt/odoo/custom-addons/* /opt/odoo/custom-addons/

                    # Ajustar Berechtigungen

                    sudo chown -R odoo:odoo /opt/odoo/custom-addons

5.5 Configurar odoo.conf

                    # Erstellen archivo de configuracion

                    sudo nano /etc/odoo/odoo.conf

                    [options]

                    admin_passwd = tu_master_password_segura

                    db_host = localhost

                    db_port = 5432

                    db_user = odoo

                    db_password = tu_password_postgres

                    addons_path = /opt/odoo/odoo/addons,/opt/odoo/custom-addons

                    data_dir = /opt/odoo/.local/share/Odoo

                    logfile = /var/log/odoo/odoo.log

                    workers = 4

                    max_cron_threads = 2

Verificacion Rapida

Antes de continuar con DNS, prueba que Odoo arranca correctamente:

sudo -u odoo /opt/odoo/venv/bin/python /opt/odoo/odoo/odoo-bin -c /etc/odoo/odoo.conf

Accede a http://IP-NUEVO-SERVIDOR:8069 y verifica que ves la pantalla de login.

Paso 6: Cambio de DNS

Redirigir el Dominio al Neu Server

15-60 minutos (propagacion: hasta 48h)

Una vez verificado que Odoo funciona en el neu Server, es momento de redirigir el trafico.

6.1 Configurar Nginx como Proxy Inverso

                    # Instalar nginx

                    sudo apt install -y nginx

                    # Erstellen configuracion fuer Odoo

                    sudo nano /etc/nginx/sites-available/odoo

                    # Contenido del archivo nginx:

                    upstream odoo {

                        server 127.0.0.1:8069;

                    }

                    upstream odoochat {

                        server 127.0.0.1:8072;

                    }

                    server {

                        listen 80;

                        server_name tu-dominio.com www.tu-dominio.com;

                        proxy_read_timeout 720s;

                        proxy_connect_timeout 720s;

                        proxy_send_timeout 720s;

                        location / {

                            proxy_pass http://odoo;

                            proxy_set_header Host $host;

                            proxy_set_header X-Real-IP $remote_addr;

                            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

                            proxy_set_header X-Forwarded-Proto $scheme;

                        }

                        location /longpolling {

                            proxy_pass http://odoochat;

                        }

                    }

                    # Activar sitio y reiniciar nginx

                    sudo ln -s /etc/nginx/sites-available/odoo /etc/nginx/sites-enabled/

                    sudo nginx -t

                    sudo systemctl restart nginx

6.2 Configurar SSL con Let's Encrypt

                    # Instalar certbot

                    sudo apt install -y certbot python3-certbot-nginx

                    # Obtener certificado SSL

                    sudo certbot --nginx -d tu-dominio.com -d www.tu-dominio.com

                    # Verificar renovacion automatica

                    sudo certbot renew --dry-run

6.3 Aktualisieren Registros DNS

En el panel de tu registrador de dominio (GoDaddy, Cloudflare, Namecheap, etc.):

Localiza los registros A fuer tu dominio
Cambia la IP del registro A principal a la IP del neu Server
Si usas www, actualiza tambien ese registro
Reduce el TTL a 300 segundos antes del cambio fuer acelerar propagacion

Tipo	Nombre	Valor (antes)	Valor (despues)	TTL
A	@	123.45.67.89	98.76.54.32	300
A	www	123.45.67.89	98.76.54.32	300

Tiempo de Propagacion DNS

Los cambios DNS pueden tardar zwischen 15 minutos y 48 horas en propagarse globalmente. Durante este periodo, algunos Benutzer veran el Server antiguo y otros el neu. Mantener ambos Server activos durante las primeras 48-72 horas.

Paso 7: Testing y Validacion

Verificar Funcionamiento Completo

30-60 minutos

La Phase de testing es critica fuer detectar Probleme antes de que afecten a Benutzer en produccion.

7.1 Checklist de Validacion Basica

Login de Benutzer funciona correctamente
Dashboard principal carga sin Fehler
Imagenes y adjuntos se visualizan correctamente
Reportes PDF se generan correctamente
Envio de emails funciona
Traunters programados (cron) se ejecutan

7.2 Verificar Logs de Fehler

                    # Revisar logs de Odoo

                    tail -f /var/log/odoo/odoo.log

                    # Filtrar solo Fehler

                    grep -i Fehler /var/log/odoo/odoo.log | tail -50

                    # Revisar logs de nginx

                    tail -f /var/log/nginx/Fehler.log

7.3 Probar Modulos Criticos

Para cada modulo instalado, verifica al menos una operacion critica:

Modulo	Prueba Recomendada
Ventas	Erstellen cotizacion, confirmar pedido, generar factura PDF
Compras	Erstellen orden de compra, recibir productos
Inventario	Verificar stock, realizar transferencia
Contabilidad	Revisar asientos, generar reporte de balance
CRM	Ver oportunidades, enviar email von registro
Website	Verificar pagina publica, probar formulario de Kontakt

7.4 Validar Integridad de Datos

                    # Vergleichen conteos de registros importantes

                    # En Server ORIGEN:

                    psql -U odoo -d tu_base_Daten -c "SELECT 'partners' as tabla, COUNT(*) FROM res_partner UNION ALL SELECT 'products', COUNT(*) FROM product_template UNION ALL SELECT 'invoices', COUNT(*) FROM account_move WHERE move_type IN ('out_invoice', 'in_invoice');"

                    # Repetir en Server DESTINO y vergleichen resultados

Migracion Exitosa

Si todos los tests pasan correctamente, la migracion ha sido exitosa. Mantener el Server antiguo apagado (no eliminado) durante al menos 7 dias como backup de emergencia.

Fehler Comunes y Loesungen

Estos son los Probleme mas frecuentes durante migraciones de Odoo y como resolverlos:

Filestore no encontrado

Las imagenes y adjuntos no aparecen despues de restaurar.

Solucion: Verificar que el filestore esta en la ruta correcta indicada en data_dir de odoo.conf. Los Berechtigungen deben ser del Benutzer odoo.

Version PostgreSQL incompatible

Fehler: "pg_restore: unsupported version" al restaurar backup.

Solucion: Instalar la misma version o superior de PostgreSQL. No es posible restaurar backups de versiones neus en versiones antiguas.

Modulo no encontrado

Odoo no arranca por falta de modulo instalado.

Solucion: Copiar modulos custom al Server neu. Aktualisieren addons_path en odoo.conf. Ejecutar: pip install [dependencia faltante].

Permisos de directorio

Fehler de escritura en logs o filestore.

Solucion: sudo chown -R odoo:odoo /opt/odoo/ /var/log/odoo/ y verificar que el servicio corre como Benutzer odoo.

SSL/HTTPS no funciona

Certificado no valido o Fehler de mixed content.

Solucion: Regenerar certificado con certbot. Verificar proxy_set_header X-Forwarded-Proto en nginx. Aktualisieren web.base.url en ir_config_fuermeter.

Emails no se envian

Fehler de conexion SMTP despues de migrar.

Solucion: Verificar configuracion de Server de E-Mail saliente en Configuracion > Server. La IP neu puede necesitar whitelist en el Server SMTP.

Longpolling no funciona

Chat y notificaciones en tiempo real no funcionan.

Solucion: Verificar configuracion nginx fuer /longpolling (puerto 8072). Habilitar workers y gevent en odoo.conf.

Cron jobs no ejecutan

Las acciones programadas no se disfuern.

Solucion: Verificar max_cron_threads > 0 en odoo.conf. Revisar ir.cron en modo desarrollador fuer ver Fehler de ejecucion.

Haeufig gestellte Fragen ueber Migracion de Odoo

Cuanto tiempo tarda migrar Odoo a otro hosting?

Una migracion tipica de Odoo tarda zwischen 2-6 horas dependiendo del tamano de la Datenbank y filestore. Para bases de Daten pequenas (menos de 5GB) puede completarse en 2 horas. Instalaciones grosss con muchos archivos pueden requerir 6-8 horas o mas.

Puedo migrar Odoo sin tiempo de inactividad?

Es posible minimizar el downtime usando tecnicas de replicacion. La estrategia recomendada es: prefuerr el neu Server, sincronizar Daten, hacer un backup final rapido y cambiar DNS. El tiempo de inactividad minimo es de 15-30 minutos fuer el cambio final.

Que archivos necesito fuer migrar Odoo?

Los componentes esenciales son: 1) Backup de Datenbank PostgreSQL (pg_dump), 2) Directorio filestore completo (~/.local/share/Odoo/filestore/), 3) Archivo de configuracion odoo.conf, 4) Modulos personalizados (carpeta addons custom). Opcionalmente: certificados SSL y configuracion nginx.

Como hago backup de la Datenbank Odoo?

Usa el comando: pg_dump -Fc -h localhost -U odoo nombre_base_Daten > backup.dump. El formato custom (-Fc) permite restauracion flexible. Alternativamente, von la interfaz web de Odoo en /web/database/manager puedes exportar un archivo ZIP que incluye Datenbank y filestore.

Que hacer si la migracion de Odoo falla?

Mantener siempre el Server original funcionando hasta confirmar que todo funciona. Los Fehler mas comunes son: versiones incompatibles de PostgreSQL, Berechtigungen incorrectos en filestore, modulos faltantes. Revisa los logs en /var/log/odoo/odoo.log fuer diagnosticar Probleme especificos.

Puedo migrar de Odoo Community a Enterprise durante el cambio de hosting?

Si, es posible pero requiere pasos adicionales. Primero migra normalmente, luego activa la licencia Enterprise y agrega los modulos enterprise. La Datenbank Community es compatible con Enterprise. Recomendamos hacer esta actualizacion despues de confirmar que la migracion basica funciona.

Como migro los modulos personalizados de Odoo?

Copia el directorio completo de modulos custom al neu Server. Asegurate de que la ruta este configurada en addons_path del archivo odoo.conf. Despues de restaurar la Datenbank, actualiza los modulos von la interfaz de aplicaciones o con: odoo -u all -d nombre_base_Daten.

Es necesario aktualisieren la version de Odoo al migrar?

No es obligatorio, pero es una oportunidad ideal fuer aktualisieren. Si decides aktualisieren version (ej: de Odoo 17 a 18), hazlo DESPUES de confirmar que la migracion al neu hosting funciona con la version actual. Las actualizaciones de version requieren scripts de migracion especificos.