🐧 Cómo instalar Odoo 18 Community en Ubuntu, paso a paso (Guía 2025)
Tiempo estimado: 25–40 minutos · Dificultad: Básica
¿Es tu primera vez con Odoo? Esta guía te explica, con lenguaje sencillo, cómo instalar Odoo 18 Community en Ubuntu 22.04 LTS o superior. Iremos paso a paso: preparar el sistema, base de datos, dependencias, descargar Odoo, configurarlo y arrancarlo como servicio.
✅ Requisitos previos
- Ubuntu 22.04 LTS o superior (servidor o equipo local).
- Usuario con permisos
sudo. - Conexión a Internet.
- Recomendado: 2 GB de RAM y 30 GB de disco libre.
Actualiza el sistema (muy importante antes de instalar nada):
sudo apt update && sudo apt upgrade -y
Instala herramientas básicas (las usaremos en la guía):
sudo apt install git wget curl nano -y
1) Instalar PostgreSQL (la base de datos de Odoo)
Odoo guarda toda la información en PostgreSQL. Lo instalamos con:
sudo apt install postgresql -y
Ahora creamos un usuario de base de datos para Odoo. Usaremos el nombre odoo18 por claridad.
sudo -u postgres createuser -s odoo18
Nota: Este comando no muestra mensaje de éxito; si no ves errores, se creó bien.
2) Instalar dependencias de Python
Odoo 18 usa Python 3.10+ y varias librerías del sistema. Instálalas con:
sudo apt install python3 python3-pip python3-dev python3-venv build-essential \
libxslt-dev libzip-dev libldap2-dev libsasl2-dev libjpeg-dev libpq-dev libffi-dev libxml2-dev -y
3) Crear el usuario del sistema y la carpeta de trabajo
Para mantener limpio y seguro el servidor, creamos un usuario del sistema dedicado:
sudo adduser --system --home=/opt/odoo18 --group odoo18
Este usuario tendrá su propia “casa” en /opt/odoo18 para alojar Odoo.
4) Descargar Odoo Community (código fuente)
Entramos como el usuario que acabamos de crear y descargamos Odoo desde GitHub en la versión 18:
sudo su - odoo18
git clone https://github.com/odoo/odoo.git -b 18.0 odoo18
cd odoo18
¿Qué hace -b 18.0? Indica a Git que traiga exactamente la rama de Odoo 18.
5) Crear un entorno virtual de Python e instalar requisitos
El entorno virtual evita conflictos con otras apps Python del sistema.
python3 -m venv venv
source venv/bin/activate
pip install wheel
pip install -r requirements.txt
Cuando termine, tendrás todas las librerías de Python que Odoo necesita.
6) Configurar Odoo (archivo odoo.conf)
Creamos una carpeta de configuración y el archivo principal de Odoo:
sudo mkdir /etc/odoo18
sudo nano /etc/odoo18/odoo.conf
Pega dentro lo siguiente (puedes cambiar la contraseña maestra y rutas si lo necesitas):
[options]
; Puerto de Odoo (puedes cambiarlo si 8069 está ocupado)
xmlrpc_port = 8069
; Ruta a los addons oficiales
addons_path = /opt/odoo18/odoo18/addons
; Carpeta de datos (sesiones, archivos subidos, etc.)
data_dir = /opt/odoo18/.local/share/Odoo
; Usuario de base de datos (el que creaste antes)
db_user = odoo18
; Contraseña maestra para gestionar bases de datos desde la web
admin_passwd = master_password_123
Guarda y cierra: en Nano, pulsa Ctrl+O (Enter) y luego Ctrl+X.
7) Arrancar Odoo por primera vez (modo directo)
Ejecuta el binario de Odoo usando el Python del entorno virtual y la configuración:
/opt/odoo18/odoo18/venv/bin/python /opt/odoo18/odoo18/odoo-bin -c /etc/odoo18/odoo.conf
Abre tu navegador y entra en:
Deberías ver la pantalla de creación de base de datos. Elige un nombre, pon una contraseña de administrador segura y listo: ¡Odoo 18 Community funcionando! 🎉
8) (Opcional) Crear un servicio para que Odoo se inicie solo
Si quieres que Odoo se inicie automáticamente al encender el servidor, crea un servicio de systemd:
sudo nano /etc/systemd/system/odoo18.service
Pega este contenido:
[Unit]
Description=Odoo 18 Community
After=network.target postgresql.service
[Service]
User=odoo18
Group=odoo18
ExecStart=/opt/odoo18/odoo18/venv/bin/python /opt/odoo18/odoo18/odoo-bin -c /etc/odoo18/odoo.conf
Restart=always
[Install]
WantedBy=multi-user.target
Actívalo y arráncalo:
sudo systemctl daemon-reload
sudo systemctl enable odoo18
sudo systemctl start odoo18
sudo systemctl status odoo18
9) (Opcional) Usar Nginx como proxy y certificar con HTTPS
Para exponer Odoo en Internet con HTTPS, es recomendable usar Nginx delante de Odoo (que escucha en 8069). Resumen rápido:
- Instala Nginx:
sudo apt install nginx -y - Configura un server block que haga proxy_pass a
http://127.0.0.1:8069. - Emite certificados con
certbot(Let’s Encrypt) para tener HTTPS gratuito.
Si estás empezando o es un entorno local, puedes saltarte este paso.
10) Solución de problemas frecuentes
| Problema | Causa habitual | Cómo se arregla |
|---|---|---|
psycopg2 no se instala |
Falta libpq-dev |
sudo apt install libpq-dev y repetir pip install -r requirements.txt |
| “Port 8069 already in use” | Otro servicio usa ese puerto | Cambia xmlrpc_port en /etc/odoo18/odoo.conf (por ejemplo 8070) y reinicia Odoo |
| Pantalla en blanco o error 500 | Addons corruptos o permisos | Revisa logs con sudo journalctl -u odoo18 -f o tail -f /var/log/syslog |
| No puedo crear la base de datos | Usuario de DB incorrecto | Comprueba que db_user = odoo18 y que existe en PostgreSQL |
FAQ (preguntas rápidas)
¿Puedo instalar Odoo en otra ruta? Sí, pero actualiza todas las rutas del archivo odoo.conf y del servicio systemd.
¿Odoo 18 funciona en Ubuntu 24.04? Sí, el proceso es muy similar. Mantén Python y dependencias actualizadas.
¿Cómo actualizo Odoo más adelante? Para entornos de pruebas: git pull en la carpeta del código y reinstala dependencias si hay cambios en requirements.txt. En producción, planifica copias de seguridad antes.
🚀 Próximos pasos recomendados
- 🧾 Configura tu primera empresa y usuarios.
- 💰 Activa módulos contables y la localización española.
- 🗄️ Automatiza copias de seguridad y tareas programadas (cron).
¿Quieres aprender Odoo paso a paso con ejemplos reales? Descubre nuestros cursos y videotutoriales en formaodoo.es.
🐧 Cómo instalar Odoo 18 Community en Ubuntu, paso a paso (Guía 2025)
Tiempo estimado: 25–40 minutos · Dificultad: Básica
¿Es tu primera vez con Odoo? Esta guía te explica, con lenguaje sencillo, cómo instalar Odoo 18 Community en Ubuntu 22.04 LTS o superior. Iremos paso a paso: preparar el sistema, base de datos, dependencias, descargar Odoo, configurarlo y arrancarlo como servicio.
✅ Requisitos previos
- Ubuntu 22.04 LTS o superior (servidor o equipo local).
- Usuario con permisos
sudo. - Conexión a Internet.
- Recomendado: 2 GB de RAM y 30 GB de disco libre.
Actualiza el sistema (muy importante antes de instalar nada):
sudo apt update && sudo apt upgrade -y
Instala herramientas básicas (las usaremos en la guía):
sudo apt install git wget curl nano -y
1) Instalar PostgreSQL (la base de datos de Odoo)
Odoo guarda toda la información en PostgreSQL. Lo instalamos con:
sudo apt install postgresql -y
Ahora creamos un usuario de base de datos para Odoo. Usaremos el nombre odoo18 por claridad.
sudo -u postgres createuser -s odoo18
Nota: Este comando no muestra mensaje de éxito; si no ves errores, se creó bien.
2) Instalar dependencias de Python
Odoo 18 usa Python 3.10+ y varias librerías del sistema. Instálalas con:
sudo apt install python3 python3-pip python3-dev python3-venv build-essential \
libxslt-dev libzip-dev libldap2-dev libsasl2-dev libjpeg-dev libpq-dev libffi-dev libxml2-dev -y
3) Crear el usuario del sistema y la carpeta de trabajo
Para mantener limpio y seguro el servidor, creamos un usuario del sistema dedicado:
sudo adduser --system --home=/opt/odoo18 --group odoo18
Este usuario tendrá su propia “casa” en /opt/odoo18 para alojar Odoo.
4) Descargar Odoo Community (código fuente)
Entramos como el usuario que acabamos de crear y descargamos Odoo desde GitHub en la versión 18:
sudo su - odoo18
git clone https://github.com/odoo/odoo.git -b 18.0 odoo18
cd odoo18
¿Qué hace -b 18.0? Indica a Git que traiga exactamente la rama de Odoo 18.
5) Crear un entorno virtual de Python e instalar requisitos
El entorno virtual evita conflictos con otras apps Python del sistema.
python3 -m venv venv
source venv/bin/activate
pip install wheel
pip install -r requirements.txt
Cuando termine, tendrás todas las librerías de Python que Odoo necesita.
6) Configurar Odoo (archivo odoo.conf)
Creamos una carpeta de configuración y el archivo principal de Odoo:
sudo mkdir /etc/odoo18
sudo nano /etc/odoo18/odoo.conf
Pega dentro lo siguiente (puedes cambiar la contraseña maestra y rutas si lo necesitas):
[options]
; Puerto de Odoo (puedes cambiarlo si 8069 está ocupado)
xmlrpc_port = 8069
; Ruta a los addons oficiales
addons_path = /opt/odoo18/odoo18/addons
; Carpeta de datos (sesiones, archivos subidos, etc.)
data_dir = /opt/odoo18/.local/share/Odoo
; Usuario de base de datos (el que creaste antes)
db_user = odoo18
; Contraseña maestra para gestionar bases de datos desde la web
admin_passwd = master_password_123
Guarda y cierra: en Nano, pulsa Ctrl+O (Enter) y luego Ctrl+X.
7) Arrancar Odoo por primera vez (modo directo)
Ejecuta el binario de Odoo usando el Python del entorno virtual y la configuración:
/opt/odoo18/odoo18/venv/bin/python /opt/odoo18/odoo18/odoo-bin -c /etc/odoo18/odoo.conf
Abre tu navegador y entra en:
Deberías ver la pantalla de creación de base de datos. Elige un nombre, pon una contraseña de administrador segura y listo: ¡Odoo 18 Community funcionando! 🎉
8) (Opcional) Crear un servicio para que Odoo se inicie solo
Si quieres que Odoo se inicie automáticamente al encender el servidor, crea un servicio de systemd:
sudo nano /etc/systemd/system/odoo18.service
Pega este contenido:
[Unit]
Description=Odoo 18 Community
After=network.target postgresql.service
[Service]
User=odoo18
Group=odoo18
ExecStart=/opt/odoo18/odoo18/venv/bin/python /opt/odoo18/odoo18/odoo-bin -c /etc/odoo18/odoo.conf
Restart=always
[Install]
WantedBy=multi-user.target
Actívalo y arráncalo:
sudo systemctl daemon-reload
sudo systemctl enable odoo18
sudo systemctl start odoo18
sudo systemctl status odoo18
9) (Opcional) Usar Nginx como proxy y certificar con HTTPS
Para exponer Odoo en Internet con HTTPS, es recomendable usar Nginx delante de Odoo (que escucha en 8069). Resumen rápido:
- Instala Nginx:
sudo apt install nginx -y - Configura un server block que haga proxy_pass a
http://127.0.0.1:8069. - Emite certificados con
certbot(Let’s Encrypt) para tener HTTPS gratuito.
Si estás empezando o es un entorno local, puedes saltarte este paso.
10) Solución de problemas frecuentes
| Problema | Causa habitual | Cómo se arregla |
|---|---|---|
psycopg2 no se instala |
Falta libpq-dev |
sudo apt install libpq-dev y repetir pip install -r requirements.txt |
| “Port 8069 already in use” | Otro servicio usa ese puerto | Cambia xmlrpc_port en /etc/odoo18/odoo.conf (por ejemplo 8070) y reinicia Odoo |
| Pantalla en blanco o error 500 | Addons corruptos o permisos | Revisa logs con sudo journalctl -u odoo18 -f o tail -f /var/log/syslog |
| No puedo crear la base de datos | Usuario de DB incorrecto | Comprueba que db_user = odoo18 y que existe en PostgreSQL |
FAQ (preguntas rápidas)
¿Puedo instalar Odoo en otra ruta? Sí, pero actualiza todas las rutas del archivo odoo.conf y del servicio systemd.
¿Odoo 18 funciona en Ubuntu 24.04? Sí, el proceso es muy similar. Mantén Python y dependencias actualizadas.
¿Cómo actualizo Odoo más adelante? Para entornos de pruebas: git pull en la carpeta del código y reinstala dependencias si hay cambios en requirements.txt. En producción, planifica copias de seguridad antes.
🚀 Próximos pasos recomendados
- 🧾 Configura tu primera empresa y usuarios.
- 💰 Activa módulos contables y la localización española.
- 🗄️ Automatiza copias de seguridad y tareas programadas (cron).
¿Quieres aprender Odoo paso a paso con ejemplos reales? Descubre nuestros cursos y videotutoriales en formaodoo.es.