Instalar Saleor con Docker
Sigue la guía de los stacks de Docker para instalar Saleor 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 1,5 GB de disco para las imágenes y 1,5 GB de RAM. En reposo usa en total cerca de 1,3 GiB (unos 530 MiB la API, 450 MiB el worker de Celery y 260 MiB el beat). El primer arranque tarda unos 2 minutos, casi todo en las migraciones.
Variables obligatorias
| Variable | Qué debe contener |
|---|---|
SALEOR_URL |
URL pública del sitio, por ejemplo https://tienda.example.com. |
SITE_ADDRESS |
El dominio del sitio, por ejemplo tienda.example.com. |
SECRET_KEY |
Clave secreta de Saleor. |
DB_PASSWORD |
Contraseña de la base de datos. |
SALEOR_ADMIN_EMAIL y SALEOR_ADMIN_PASSWORD |
Correo y contraseña del administrador. Se crea si no existe un usuario con ese correo (si cambias el correo después, se crea otro administrador) y la contraseña solo se aplica al crearlo. |
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. |
Configuración inicial de la tienda
La tienda se crea configurada para Chile: canal “Tienda” en CLP, país CL, bodega en Santiago, zona de despacho Chile con un método “Despacho” gratuito, IVA de 19 % con precios que lo incluyen, pedidos sin pago permitidos y correos en español. Si vendes en otro país, cambia SALEOR_STORE_NAME, SALEOR_CHANNEL_NAME, SALEOR_CURRENCY, SALEOR_COUNTRY, SALEOR_CITY, SALEOR_ZONE_NAME, SALEOR_TAX_RATE, SALEOR_PRICES_INCLUDE_TAX antes del primer arranque: estos valores solo se aplican en la instalación inicial y después se modifican desde el dashboard (SALEOR_COUNTRY además se usa en cada arranque como país por defecto de Saleor, por ejemplo en los checkouts nuevos). SALEOR_EMAIL_LOCALE (el formato de los montos en los correos) se lee en cada arranque, así que puedes cambiarlo cuando quieras.
Acceso
Cuando setup termina, el dashboard queda disponible en /dashboard/ de tu dominio (la raíz redirige a él), con el correo y la contraseña de SALEOR_ADMIN_EMAIL y SALEOR_ADMIN_PASSWORD. La API GraphQL está en /graphql/.
Actualizaciones
Saleor se actualiza cambiando SALEOR_VERSION en el .env, junto con SALEOR_DASHBOARD_VERSION (la última de la misma línea menor), y ejecutando docker compose up -d: se descargan las nuevas imágenes y setup aplica las migraciones antes de que arranque la API. Respalda antes y, si cambias de versión menor, lee las notas de la versión de Saleor.
Restaurar un respaldo
Los respaldos incluyen la base de datos, los archivos subidos (media) y la clave RSA que firma los tokens de la API y los webhooks. Para restaurar uno:
docker compose stop api worker beat
docker compose run --rm --no-deps backup restore <fecha>
docker compose exec valkey valkey-cli FLUSHALL
docker compose up -d
Notas
- Saleor es headless: el stack incluye el dashboard y la API, pero no la tienda pública para los clientes, que es una aplicación aparte que usa la API.
- Saleor no trae un método de pago sin conexión: los pedidos quedan sin pagar y se confirman y marcan como pagados desde el dashboard (como una transferencia bancaria).
- El dashboard se muestra en inglés por defecto; cada usuario puede cambiarlo a español desde el propio dashboard.
Siguiente paso
Con Saleor funcionando, configúralo como origen de datos en BillMySales siguiendo la configuración inicial.