1.3 KiB
| title |
|---|
| Assets Volume Change |
Migration Guide: Assets Volume Change
Background
The way sites/assets is handled has changed. Previously, assets were stored inside the a volume and persisted across container recreations. This could caused stale or mismatched assets after image updates. See Assets Reference for details on the new approach.
Who needs to migrate?
Anyone running an existing setup where the sites volume was created with frappe_docker version v3.1.0 or lower.
New setups are unaffected.
Migration Steps
-
Pull an updated Image
-
Recreate all containers (
docker compose up --force-recreate) -
Enter the backend container
docker compose -p frappe exec -it backend bash -
Run commands in container
rm -rf /home/frappe/frappe-bench/sites/assets && \ ln -s /home/frappe/frappe-bench/assets /home/frappe/frappe-bench/sites/assets && \ exit
What this does
Replaces sites/assets directory with a symlink pointing to /home/frappe/frappe-bench/assets, which lives in the image layer. This ensures assets always match the running image version.
After this manual migration is made once no further steps are needed on further deployments.