Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Fixed Docker Compose Postgres 18 volume mount in deployment docs (#15081)

Damian Legawiecda016eb3ef51
diff --git a/docs/developer/deployment/docker.mdx b/docs/developer/deployment/docker.mdx
index b94b726383..8d96f7d3e9 100644
--- a/docs/developer/deployment/docker.mdx
+++ b/docs/developer/deployment/docker.mdx
@@ -39,7 +39,7 @@ services:
environment:
POSTGRES_HOST_AUTH_METHOD: trust
volumes:
- - postgres_data:/var/lib/postgresql/data
+ - postgres_data:/var/lib/postgresql
healthcheck:
test: pg_isready -h 127.0.0.1 -U postgres
interval: 5s
@@ -85,6 +85,10 @@ docker compose up -d
The database is created and migrated on first boot. The app is available at [http://localhost:3000](http://localhost:3000).
+<Note>
+ PostgreSQL 18 images keep data in a version-specific directory under `/var/lib/postgresql`, so the volume above must be empty on first boot. If you already have a volume with PostgreSQL 17 (or older) data, migrate it first — dump and restore into a fresh PostgreSQL 18 volume, or use `pg_upgrade`.
+</Note>
+
### Scaling out the worker
Background jobs run inside the web container by default. When job load deserves its own process, split it out — same image, no rebuild: set `SOLID_QUEUE_IN_PUMA: "false"` on `web` and add a worker service: