Instalar Odoo con Docker
Sigue la guía de los stacks de Docker para instalar Odoo con nuestro stack y ten en cuenta lo propio de esta plataforma. El detalle completo está en el README del repositorio.
Recursos
El stack necesita unos 3 GB de disco para las imágenes y 2 GB de RAM o más para Odoo. En reposo usa unos 11 MiB en Caddy, unos 275 MiB en Odoo (crece con el uso) y unos 110 MiB en PostgreSQL. El primer arranque tarda cerca de un minuto.
Variables obligatorias
| Variable | Qué debe contener |
|---|---|
ODOO_URL |
URL pública de tu ERP, por ejemplo https://erp.example.com. |
SITE_ADDRESS |
El dominio de tu ERP, por ejemplo erp.example.com. |
ODOO_MASTER_PASSWORD |
Contraseña maestra de Odoo. El gestor web de bases de datos está desactivado, pero Odoo la exige para algunas operaciones. |
DB_PASSWORD |
Contraseña de la base de datos. |
ODOO_ADMIN_PASSWORD y ODOO_ADMIN_EMAIL |
Contraseña y correo del administrador. Solo se aplican en la instalación inicial: después se cambian desde Odoo, no en el .env. |
SMTP_HOST |
Recomendada: el stack arranca sin ella, pero la plataforma no podrá enviar correos. Servidor SMTP. Completa también SMTP_PORT, SMTP_SECURE, SMTP_USER, SMTP_PASSWORD y SMTP_FROM según tu proveedor. Sin SMTP_HOST (ni un servidor de correo configurado en Odoo), Odoo no puede enviar cotizaciones, facturas ni recuperaciones de contraseña. |
Configuración inicial
La empresa se crea configurada para Chile (idioma es_CL, país CL, moneda CLP y zona horaria America/Santiago). Si operas en otro país, cambia ODOO_COMPANY_NAME, ODOO_LANG, ODOO_COUNTRY, ODOO_CURRENCY y ODOO_TIMEZONE antes del primer arranque: estos valores solo se aplican en la instalación inicial y después se modifican desde Odoo.
Los módulos de ODOO_MODULES (por defecto sale_management,account) se revisan en cada arranque, así que los que agregues después también se instalan. Con país CL, account instala además la localización chilena (l10n_cl).
Acceso
Cuando setup termina, Odoo queda disponible en tu dominio, con el usuario admin (configurable con ODOO_ADMIN_USER antes del primer arranque) y la contraseña de ODOO_ADMIN_PASSWORD.
Actualizaciones
Odoo se actualiza cambiando ODOO_VERSION en el .env por una compilación más reciente de la misma versión mayor (por ejemplo, 19.0-<fecha>, que se publica semanalmente) y ejecutando docker compose up -d: setup actualiza todos los módulos (-u all). Respalda antes. Una nueva versión mayor (por ejemplo, de 19 a 20) requiere el proceso de migración de Odoo, que este stack no hace: setup se niega a arrancarla.
Restaurar un respaldo
Los respaldos incluyen la base de datos y el filestore (los archivos adjuntos). Para restaurar uno:
docker compose run --rm --no-deps backup restore <fecha>
docker compose restart odoo
Notas
- El servidor de correo que configura el stack admite STARTTLS (
SMTP_SECURE=tls, el valor por defecto, puerto 587), pero no SMTPS (puerto 465). Para usar SMTPS, agrega un servidor en Settings > Technical > Outgoing Mail Servers. - El Punto de Venta (
point_of_sale) no se instala por defecto: agrégalo aODOO_MODULESy ejecutadocker compose up -d, o instálalo desde el menú Apps.
Siguiente paso
Con Odoo funcionando, configúralo como origen de datos en BillMySales siguiendo la configuración inicial.