Instalar Odoo con Docker en Windows paso a paso

Si quieres probar Odoo 17 en tu PC con Windows, Docker es la forma más sencilla y reproducible. Esta guía te lleva paso a paso desde cero hasta tener Odoo funcionando en localhost:8069. Asume que no eres técnico avanzado pero sabes seguir instrucciones.

Nota: esta guía es para probar Odoo y aprender. Para uso productivo en una empresa real, te recomendamos una solución con Verifactu, backups y configuración hechos (como nuestro paquete básico). Hacer esto a mano es viable pero requiere mantenimiento continuo.

Requisitos previos

Antes de empezar, necesitas:

• Windows 10 (64 bits) versión 1903+ o Windows 11.
• Mínimo 8 GB de RAM (16 GB recomendado).
• Mínimo 20 GB de disco libre.
• Conexión a internet estable (descargas iniciales pesadas).
• Cuenta de Windows con permisos de administrador.
• Virtualización activada en BIOS (suele estar activada por defecto en hardware moderno).

Si no estás seguro de la virtualización: abre el Administrador de Tareas → pestaña Rendimiento → CPU. Debería aparecer “Virtualización: Habilitado”. Si pone “Deshabilitado”, tienes que habilitarla en BIOS antes de continuar.

Paso 1 — Instalar Docker Desktop

Descarga

Ve a docker.com/products/docker-desktop y descarga Docker Desktop for Windows. El instalador pesa ~500 MB.

Ejecuta el instalador

• Durante la instalación, marca la opción “Use WSL 2 instead of Hyper-V” (recomendado para Windows 10/11).
• Acepta los términos.
• Reinicia el PC cuando te lo pida.

Primer arranque

Después del reinicio, abre Docker Desktop. La primera vez:

• Acepta el acuerdo de servicio.
• Si te pide hacer login, puedes saltártelo (no es obligatorio para uso personal).
• Espera a que aparezca el icono de Docker en la barra de tareas con el círculo verde (significa “running”).

Verificación

Abre PowerShell (no CMD, no como administrador necesariamente) y ejecuta:

docker --version

Deberías ver algo como Docker version 24.0.x, build xxxx. Si lo ves, Docker está listo.

Paso 2 — Crear la carpeta del proyecto

Crea una carpeta en una ubicación cómoda. Por ejemplo:

mkdir C:\Odoo
cd C:\Odoo

Esta será la carpeta donde tendrás los archivos de configuración. Evita carpetas con espacios o tildes en el path (como C:\Mi Negocio\Odoo); Docker se lleva mejor con paths sencillos.

Paso 3 — Crear el archivo docker-compose.yml

Crea un archivo llamado docker-compose.yml dentro de C:\Odoo con este contenido:

version: "3.8"

services:
  postgres:
    image: postgres:15
    container_name: odoo17-postgres
    environment:
      POSTGRES_USER: odoo
      POSTGRES_PASSWORD: odoo_password_local
      POSTGRES_DB: postgres
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

  odoo:
    image: odoo:17.0
    container_name: odoo17-web
    depends_on:
      - postgres
    environment:
      HOST: postgres
      USER: odoo
      PASSWORD: odoo_password_local
    ports:
      - "8069:8069"
    volumes:
      - odoo-data:/var/lib/odoo
    restart: unless-stopped

volumes:
  postgres-data:
  odoo-data:

Importante: cambia odoo_password_local por una contraseña tuya. Es la contraseña de la base de datos PostgreSQL. No la compartas.

Puedes editar el fichero con Notepad o, mejor, con Visual Studio Code.

Paso 4 — Arrancar el stack

Desde PowerShell, dentro de C:\Odoo, ejecuta:

docker-compose up -d

La primera vez, Docker descargará las imágenes (odoo:17.0 ~600 MB, postgres:15 ~150 MB). Tardará unos minutos según tu conexión.

Verificación

Cuando termine, ejecuta:

docker-compose ps

Deberías ver dos contenedores en estado Up:

NAME                STATUS
odoo17-postgres     Up X seconds
odoo17-web          Up X seconds

Si están abajo (Exit o Restarting), revisa los logs:

docker-compose logs odoo

Paso 5 — Acceder a Odoo

Abre tu navegador (Chrome, Edge, Firefox) y ve a:

http://localhost:8069

Verás la pantalla de creación de base de datos de Odoo:

• Master Password: una contraseña que te invente Odoo aleatoria — la verás en la primera pantalla. Guárdala, te hará falta para administrar bases de datos.
• Database Name: nombre de tu base de datos. Por ejemplo odoo_test.
• Email y Password: el usuario administrador inicial.
• Country: España.
• Language: Spanish (Spain).
• Demo data: marca la casilla para tener datos de ejemplo (recomendado para probar).

Pulsa Create database. Tardará 1-2 minutos en crearse.

Cuando termine, te logueas con el email y password que pusiste y verás la pantalla principal de Odoo.

Paso 6 — Activar la localización española

Con la base de datos creada, ahora hay que activar la localización española y los módulos de facturación.

Activar modo desarrollador

Ve a Settings → Activate Developer Mode (o añade ?debug=1 a la URL).

Instalar módulos

Ve a Apps → Update Apps List. Después busca e instala (en este orden):

1. Spain - Accounting (l10n_es).
2. Invoicing (account).
3. Spain - Verifactu (l10n_es_edi_verifactu) — este es el módulo crítico para cumplir el RD 1007/2023.

Nota: l10n_es_edi_verifactu requiere haber configurado primero la empresa con NIF español. Ve a Settings → Companies y rellena los datos antes de instalar el módulo.

Configurar empresa y certificado

• En Settings → Companies → Tu Empresa, configura: nombre, NIF, dirección, teléfono.
• Si quieres usar Verifactu, en Accounting → Configuration → Verifactu configura el certificado FNMT y el modo (test o producción).

Paso 7 — Verificar Verifactu (opcional)

Para verificar que Verifactu funciona (en modo de pruebas):

1. Crea una factura de prueba: Accounting → Customers → Invoices → Create.
2. Confirma la factura.
3. Verifica que aparece un QR en el PDF generado.
4. Si tienes certificado de pruebas configurado, debería enviarse a la sede de pruebas de la AEAT.

Para detalles del flujo completo, lee nuestro artículo sobre cómo configurar Verifactu en Odoo.

Paso 8 — Operación diaria

Para parar Odoo

cd C:\Odoo
docker-compose stop

Para arrancarlo otra vez

cd C:\Odoo
docker-compose start

Para ver logs

docker-compose logs -f odoo

Pulsa Ctrl+C para salir del log.

Para hacer backup manual de la base de datos

docker exec odoo17-postgres pg_dump -U odoo -d odoo_test | gzip > backup_$(Get-Date -Format "yyyyMMdd").sql.gz

Esto te crea un fichero backup_20260605.sql.gz que puedes copiar a otro disco. Hacer backups regulares es responsabilidad tuya en una instalación on-premise. Más detalle en copias de seguridad en software de facturación.

Limitaciones de esta instalación “manual”

Lo que has hecho funciona y vale para probar Odoo, pero no es una instalación productiva seria por estas razones:

• Sin backups automáticos: tienes que hacerlos a mano.
• Sin lockdown de seguridad: el menú “Apps” sigue visible, cualquier usuario admin puede instalar lo que quiera.
• Sin Verifactu preconfigurado: hay que configurarlo paso a paso.
• Sin actualizaciones gestionadas: si sale Odoo 17.1, tienes que migrar tú.
• Sin soporte: si tienes un problema, dependes de la comunidad o de Stack Overflow.
• Sin certificado HTTPS: el acceso es HTTP local, lo cual es seguro en localhost pero no para acceso remoto.

Para uso productivo en una empresa real, una solución llave en mano (como nuestro paquete básico de MicroFactu) cubre estos huecos: Verifactu de serie, backups automáticos, lockdown de UI, plantilla de factura personalizada, y mantenimiento opcional.

Errores comunes y soluciones

”Cannot connect to the Docker daemon”

Docker Desktop no está corriendo. Ábrelo (busca “Docker Desktop” en el menú inicio) y espera al círculo verde.

”Port 8069 is already in use”

Otra aplicación está usando ese puerto. Cambia en docker-compose.yml:

ports:
  - "8070:8069"

Y accede a http://localhost:8070 en su lugar.

”Database already exists”

Estás intentando crear una BD con nombre que ya existe. Usa otro nombre.

Odoo arranca pero no responde

Espera 1-2 minutos. La primera vez tarda en inicializar. Si después de 5 minutos sigue sin responder, revisa logs (docker-compose logs odoo).

”Unrecognized field” tras instalar módulo

Reinicia Odoo:

docker-compose restart odoo

Conclusión

Tienes Odoo 17 corriendo en tu Windows con Docker. Has visto que el setup es razonable pero no trivial: hay que configurar empresa, instalar módulos, gestionar backups manualmente, y mantenerlo al día.

Para probar Odoo, esta guía es perfecta. Para uso productivo serio (con Verifactu y backups), la mayoría de microempresas prefieren una solución llave en mano que oculte la complicación técnica.

Si quieres saltarte todo este proceso y tener Odoo + Verifactu + backups + lockdown configurados en tu PC en 48 horas sin que tengas que tocar línea de comandos, mira nuestro paquete básico.

¿Tienes problemas siguiendo esta guía? Cuéntanoslo, aunque sea para echarte una mano puntual.