Ir al contenido
Campus Cleverit · Guía Técnica · Junio 2026

Instala Odoo 19 en
Ubuntu 26.04 LTS
Resolute Raccoon

Ubuntu 26.04 viene con Python 3.14. Odoo 19 no lo soporta. Esta guía te muestra cómo resolverlo con uv y completar la instalación paso a paso desde cero.

 Odoo 19 CE + EE  Ubuntu 26.04 LTS  Python 3.12 via uv  PostgreSQL  wkhtmltopdf
⚡
¿Por qué usamos uv de Astral en lugar del entorno virtual tradicional?
Dos razones. Primera: uv es significativamente más rápido que pip tradicional y genera menos errores al instalar dependencias Python. Segunda: permite fijar una versión específica de Python para el entorno — en esta instalación usamos 3.12 — de forma que cualquier cambio de versión en el futuro sea controlado y explícito, sin sorpresas.

Cambios respecto a Ubuntu 24.04

Solo 2 pasos son distintos

El 90% del proceso es idéntico a la guía de 24.04. Solo cambia cómo se gestiona Python.

Concepto
Ubuntu 24.04
Ubuntu 26.04 ← esta guía
Python del sistema
3.12 (nativo)
3.14 — gestionamos con uv
Paquetes apt Python
python3-dev · python3-pip · python3-venv
Se omiten — uv los gestiona
Paso extra
—
Instalar uv + python 3.12
Crear entorno virtual
python3 -m venv venv
uv venv --python 3.12 venv
Resto del proceso
igual
igual

Antes de empezar

Requisitos previos

🖥️
Ubuntu 26.04 LTS
Servidor, VPS, VM local o bare metal. AMD64 o ARM64.
🔑
Acceso root / sudo
Necesario para instalar paquetes y crear el usuario del sistema.
🌐
Conexión a internet
Para descargar paquetes, clonar el repo de Odoo y uv.
🔗
Dominio (opcional)
Necesario para HTTPS en producción. No requerido para esta guía.

Guía de instalación

12 pasos — desde cero hasta Odoo corriendo

Ejecuta los comandos como root salvo donde se indique lo contrario.

01
Sistema
Crear usuario dedicado para Odoo

Recomendado para servidores. Si estás montando un entorno de desarrollo en tu propio equipo con Ubuntu de escritorio, puedes usar tu usuario habitual del sistema — no hace falta crear uno nuevo y evitas problemas de permisos innecesarios.

💡
Entorno local: salta este paso y continúa con tu usuario actual.
Servidor / VPS: crea el usuario dedicado con el comando de abajo.
root@server:~#
$ sudo useradd -m -d /home/odoo_dev -s /bin/bash odoo_dev
02
Sistema
Actualizar el sistema

Evita conflictos de dependencias con paquetes desactualizados.

root@server:~#
$ sudo apt update && sudo apt upgrade -y -q
03
Dependencias
Instalar paquetes y dependencias del sistema

En Ubuntu 26.04 no instalamos python3-dev, python3-pip ni python3-venv vía apt — esos los gestiona uv en el paso 05. Sí necesitamos las librerías de sistema para las extensiones C de Odoo.

root@server:~#
# Dependencias, fuentes multilengua y librerías de sistema
$ sudo apt update && \
sudo DEBIAN_FRONTEND=noninteractive apt install -y -q --no-install-recommends \ build-essential \ ca-certificates \ curl \ fonts-dejavu-core \ fonts-freefont-ttf \ fonts-freefont-otf \ fonts-noto-core \ fonts-inconsolata \ fonts-font-awesome \ fonts-roboto-unhinted \ gsfonts \ git \ gnupg \ htop \ libldap2-dev \ libpq-dev \ libsasl2-dev \ nano \ net-tools \ procps \ unzip \ zip
04
Base de datos
Instalar PostgreSQL y crear usuario
root@server:~#
$ sudo apt install postgresql postgresql-client

# Crear usuario para Odoo en PostgreSQL
$ sudo -u postgres createuser -d -R -S odoo
05
⚡ Paso clave · Solo en Ubuntu 26.04
Instalar uv y Python 3.12

Instalamos uv en /usr/local/bin para que esté disponible para todos los usuarios del servidor. A continuación fijamos Python 3.12 como versión del entorno — más rápido que pip y sin depender de la versión global del sistema.

root@server:~#
# Instalar uv en /usr/local/bin (disponible para todos los usuarios)
$ curl -LsSf https://astral.sh/uv/install.sh \
| env UV_INSTALL_DIR=/usr/local/bin sh
# Verificar
$ uv --version
uv 0.x.x (linux) ✓
# Instalar Python 3.12 (uv lo descarga automáticamente)
$ uv python install 3.12
Installed Python 3.12.x ✓
# Verificar versiones disponibles
$ uv python list
cpython-3.12.x ← usaremos esta cpython-3.14.x ← sistema (no tocar)
06
PDF
Instalar wkhtmltopdf

Necesario para generar informes PDF en Odoo. Descarga el binario para Jammy (22.04) desde el repositorio oficial — es compatible con Ubuntu 26.04. Elige amd64 o arm64 según tu arquitectura.

📦 Descargas: github.com/wkhtmltopdf/packaging/releases

root@server:~#
# 1. Descarga el .deb para Jammy desde el link anterior
# Escoge: wkhtmltox_0.12.6.x-x.jammy_amd64.deb (o arm64)

# 2. Instala el paquete descargado
$ sudo apt install -y ./wkhtmltox_*.deb

# Verificar
$ wkhtmltopdf --version
wkhtmltopdf 0.12.6.1 (with patched qt) ✓
07
Estructura
Cambiar a usuario odoo y crear directorios

A partir de aquí trabajamos como usuario odoo.

root@server:~#
$ su odoo
$ cd /home/odoo

# Crear estructura de directorios
$ mkdir -p ~/odoo_dev/odoo19/{config,log,data}

# Resultado en /home/odoo/odoo_dev/odoo19/
config ← odoo.conf data ← filestore log ← fichero de log odoo ← repo (siguiente paso) venv ← entorno virtual Python 3.12
08
Odoo
Clonar Odoo 19
odoo@server:~$
# Community Edition
$ git clone https://github.com/odoo/odoo.git \
-b 19.0 --depth 1 --single-branch ~/odoo_dev/odoo19/odoo
# Enterprise Edition — requiere:
# · Clave SSH configurada en tu cuenta de GitHub
# · Acceso al repositorio privado de Odoo Enterprise (partners)
$ git clone git@github.com:odoo/enterprise.git \
-b 19.0 --depth 1 --single-branch ~/odoo_dev/odoo19/enterprise
09
⚡ Paso clave · Solo en Ubuntu 26.04
Crear entorno virtual con Python 3.12

Con uv venv --python 3.12 el entorno queda vinculado a una versión fija de Python. Si en el futuro hay que cambiarla, se cambia de forma explícita y controlada — sin sorpresas.

odoo@server:~/odoo_dev/odoo19$
$ cd ~/odoo_dev/odoo19

# Crear entorno virtual con Python 3.12
$ uv venv --python 3.12 venv
Using Python 3.12.x Creating virtual environment at: venv ✓
# Con uv no hace falta activar el entorno
# Usa directamente la ruta al Python del venv
$ ./venv/bin/python --version
Python 3.12.x ✓
10
Python
Instalar dependencias Python de Odoo

Con uv pip la instalación es significativamente más rápida que con pip estándar. Hay que estar en la carpeta del proyecto para que uv detecte el entorno virtual automáticamente.

odoo@server:~$
# Ir a la carpeta del proyecto
$ cd ~/odoo_dev/odoo19

# Instalar dependencias con uv pip
$ uv pip install phonenumbers
$ uv pip install -r ./odoo/requirements.txt

# Verificar
$ uv pip list
11
Arranque
Iniciar Odoo por primera vez

Accede desde el navegador a http://<ip_servidor>:8069 una vez que el proceso esté activo.

odoo@server:~/odoo_dev/odoo19$
# Community Edition
$ ~/odoo_dev/odoo19/venv/bin/python ~/odoo_dev/odoo19/odoo/odoo-bin

# Enterprise Edition
$ ~/odoo_dev/odoo19/venv/bin/python \
~/odoo_dev/odoo19/odoo/odoo-bin \ --addons-path=/home/odoo/odoo_dev/odoo19/enterprise,/home/odoo/odoo_dev/odoo19/odoo/addons
# Detener
$ pkill -f odoo-bin
12
Utilidades
Script de gestión manage_odoo.sh

Crea el fichero con nano ~/odoo_dev/odoo19/manage_odoo.sh, pega el contenido, guarda con Ctrl+X → Y → Enter y dale permisos.

odoo@server:~/odoo_dev/odoo19$
#!/bin/bash

start_odoo() {
echo "Starting Odoo server..." ~/odoo_dev/odoo19/venv/bin/python ~/odoo_dev/odoo19/odoo/odoo-bin &
}

if [ $1 == 'start' ]; then
start_odoo
elif [ $1 == 'stop' ]; then
pkill -f odoo-bin
elif [ $1 == 'restart' ]; then
pkill -f odoo-bin start_odoo
fi

# Dar permisos y usar
$ chmod +x manage_odoo.sh
$ ./manage_odoo.sh start
$ ./manage_odoo.sh stop
$ ./manage_odoo.sh restart

¿Y ahora qué?

Siguientes pasos para producción

Esta guía cubre la instalación base. Para un entorno productivo real necesitas esto:

🔒
Configurar Proxy SSL + HTTPS
Nginx como proxy inverso, certificado Let's Encrypt y renovación automática. Obligatorio para pasarelas de pago y chat en tiempo real.
⚙️
Odoo como servicio systemd
Para que Odoo arranque automáticamente al reiniciar el servidor y se gestione como servicio estándar del sistema.
🛡️
Firewall + Backups automáticos
UFW configurado y backups programados de base de datos y filestore. Sin esto, el servidor no está listo para producción.

Campus Cleverit

¿Quieres ir más allá de la instalación?

Aprende a desarrollar en Odoo con base técnica real — backend, OWL, módulos, reportes e integraciones. Cursos en español orientados a producción.

 Ver todos los cursos Odoo Backend Developer →

¿Necesitas instalación rápida o soporte técnico?

 Troton Installer Pro — Odoo en 3 minutos