Instalar Odoo 19 Community en Ubuntu 24.04, Docker o Windows (y dejarlo listo para España)

Paso 1. Instala PostgreSQL

El paquete de Odoo da por hecho que PostgreSQL está en la misma máquina. Con el servidor actualizado:

sudo apt update
sudo apt install postgresql -y

En Ubuntu 24.04 esto instala PostgreSQL 16, por encima del mínimo. No crees usuarios a mano: lo hace el paquete de Odoo en el paso 3.

Paso 2. Instala wkhtmltopdf 0.12.6.1-3

Odoo convierte facturas, pedidos y albaranes a PDF con wkhtmltopdf. La documentación pide la 0.12.6 «para que admita cabeceras y pies de página», y la versión del repositorio de Ubuntu no sirve para eso.

El problema de Ubuntu 24.04: la versión 0.12.6.1-3 de wkhtmltopdf/packaging no tiene paquete para noble. Tiene para jammy (22.04), bookworm y bullseye. La salida la da la propia Odoo: su Dockerfile oficial de la 19.0 parte de ubuntu:noble e instala el paquete de jammy, comprobando su huella SHA1. Haz lo mismo:

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb
echo "967390a759707337b46d1c02452e2bb6b2dc6d59  wkhtmltox_0.12.6.1-3.jammy_amd64.deb" | sha1sum -c -
sudo apt install ./wkhtmltox_0.12.6.1-3.jammy_amd64.deb -y
wkhtmltopdf --version

La segunda línea debe responder OK. La huella es la del Dockerfile de Odoo para amd64; en un servidor ARM el paquete es el jammy_arm64 y su huella es otra (también está en ese Dockerfile).

Paso 3. Añade el repositorio de Odoo 19 e instala

Los tres comandos de la documentación, con la rama 19.0:

wget -q -O - https://nightly.odoo.com/odoo.key | sudo gpg --dearmor -o /usr/share/keyrings/odoo-archive-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/odoo-archive-keyring.gpg] https://nightly.odoo.com/19.0/nightly/deb/ ./' | sudo tee /etc/apt/sources.list.d/odoo.list
sudo apt-get update && sudo apt-get install odoo

Lo que deja hecho el paquete, según su código en la rama 19.0:

• Un usuario de sistema odoo y un usuario de PostgreSQL odoo con permiso para crear bases de datos (createuser -d -R -S odoo).
• El fichero de configuración /etc/odoo/odoo.conf, legible solo por odoo.
• El servicio odoo, que arranca con ese fichero y escribe el registro en /var/log/odoo/odoo-server.log.
• La carpeta personal del usuario odoo, /var/lib/odoo. Como el odoo.conf del paquete no fija data_dir, Odoo usa la carpeta por defecto del usuario, /var/lib/odoo/.local/share/Odoo, y ahí va el filestore (filestore/ y el nombre de la base): los adjuntos, PDF e imágenes de cada base de datos.

Si prefieres el paquete descargado (o es Enterprise), cambia el último comando por sudo apt install ./ seguido del nombre del .deb. El resto de la guía es igual.

Paso 4. Comprueba que arranca

sudo systemctl status odoo
sudo tail -n 50 /var/log/odoo/odoo-server.log

En el registro busca dos líneas. Will use the Wkhtmltopdf binary at dice que Odoo ha encontrado wkhtmltopdf. Si en su lugar sale You need Wkhtmltopdf to print a pdf version of the reports., vuelve al paso 2.

Abre http://IP-del-servidor:8069 en el navegador. Si no carga, revisa el cortafuegos del proveedor: el puerto 8069 tiene que estar abierto mientras no montes el proxy del paso 6, y cerrado después.

Paso 5. Crea la base de datos en español

La primera vez, Odoo abre el gestor de bases de datos. Arriba sale un aviso amarillo: Warning, your Odoo database manager is not protected. y una contraseña maestra generada al azar. Cópiala y guárdala: la pedirá para crear, copiar, borrar o restaurar bases. Mientras no se fija, la contraseña maestra sigue siendo la de fábrica, admin (valor por defecto de admin_passwd en el código), y la documentación recomienda desactivar el gestor en cualquier servidor abierto a internet.

Rellena el formulario así:

Por qué importa el país. Con Spain, el código de creación de la base pone España y el euro en la empresa. Y la localización española (l10n_es) se instala sola al activar Facturación, porque Odoo solo instala automáticamente un módulo de país si hay al menos una empresa de ese país. Sin país, Facturación arranca con un plan contable genérico.

La zona horaria no se pone sola. Al crear la base, Odoo solo fija la zona horaria de los usuarios si el país tiene una única zona. España tiene tres en la base de datos de zonas horarias (Europe/Madrid, Africa/Ceuta y Atlantic/Canary), así que no pone ninguna. Entra en el menú de tu avatar, Mis preferencias, y elige la Zona horaria de tu oficina. Repite con cada usuario.

Paso 6. Cierra la puerta antes de abrirla a internet

La lista de seguridad de la documentación de Odoo 19 empieza por aquí. Edita /etc/odoo/odoo.conf (con sudo) y deja algo así:

[options]
admin_passwd = una-contraseña-larga-y-aleatoria
db_user = odoo
db_name = miempresa
list_db = False
proxy_mode = True
workers = 5
max_cron_threads = 1

• admin_passwd: la contraseña maestra del gestor de bases de datos. La documentación propone generarla con python3 -c 'import base64, os; print(base64.b64encode(os.urandom(24)))'.
• list_db = False: oculta la lista de bases y bloquea el gestor de bases de datos, que según la documentación «no está pensado para producción». Funciona porque db_name dice a Odoo qué base abrir; con varias bases por servidor, usa dbfilter.
• proxy_mode = True: solo si Odoo queda detrás de un proxy con HTTPS, como Nginx. La documentación trae un ejemplo completo de Nginx que reenvía /websocket al puerto 8072 y lo demás al 8069.

Reinicia con sudo systemctl restart odoo después de cada cambio.

Paso 7. Workers y memoria

Con workers = 0 (el valor por defecto) Odoo funciona en un solo proceso con hilos: vale para probar, no para trabajar con varias personas. En producción la documentación de Odoo 19 da tres reglas:

• Máximo de workers: (núcleos × 2) + 1.
• Un worker atiende unos 6 usuarios a la vez.
• Memoria: el 80 % de las peticiones son ligeras (unos 150 MB) y el 20 % pesadas (unos 1.024 MB), así que cada proceso cuesta de media 0,8 × 150 + 0,2 × 1.024 = 324,8 MB.

Su ejemplo: 4 núcleos y 60 usuarios a la vez. Harían falta 10 workers (60 / 6), pero el máximo es 9; usa 8 workers y 1 de tareas programadas, y 9 × 324,8 MB dan unos 3 GB solo para Odoo, sin contar PostgreSQL.

Nunca workers = 1. El código de Odoo 19 marca ese caso y no genera PDF: el navegador muestra Necesita iniciar Odoo con al menos dos trabajadores para imprimir una versión pdf de los informes. Usa 0 o 2 o más.

workers = 8
max_cron_threads = 1

Paso 8. Copias de seguridad desde el primer día

La documentación pide copias diarias de las bases de datos y del filestore, guardadas en un servidor que no sea accesible desde el propio Odoo. Una copia solo de PostgreSQL no basta: los adjuntos y los PDF están en /var/lib/odoo/.local/share/Odoo/filestore/ y el nombre de la base (instalación con el paquete; en Docker, en /var/lib/odoo/filestore/).

sudo -u odoo pg_dump -Fc miempresa > miempresa-$(date +%F).dump
sudo tar czf filestore-$(date +%F).tar.gz -C /var/lib/odoo/.local/share/Odoo/filestore miempresa

Programa las dos líneas en el cron del servidor y copia los ficheros fuera. Prueba a restaurar una vez en otra máquina: es la única forma de saber que la copia vale.