App claims ERPNext v15 compatibility but fails on v15.8 – serious installation issues

[novasourcent]

I want to highlight that this app is listed as compatible with ERPNext v15, but that’s clearly not accurate for recent builds.
I’m running ERPNext v15.8 (Frappe v15.80.0) and installation completely broke my bench environment — dependency conflicts (especially boto3 and botocore), app import failures (ModuleNotFoundError: ecommerce_integrations), and restore issues followed.

I had to manually clean up my entire bench, rebuild assets, and restore from backup just to get my site running again.
This wasted hours of debugging, and it’s frustrating for users who expect proper version compatibility.

⚠️ Please test and officially update compatibility for ERPNext 15.8+, or clearly state the supported version range in the README / Marketplace listing.
Also, ensure dependencies like boto3 and botocore align with Frappe’s current pinned versions.

This needs to be fixed ASAP — otherwise, you’re breaking production benches for anyone trying to install on current stable ERPNext v15 releases.

[candemiralp]

Hello @novasourcent,

I am also experiencing the same issue on a fresh instance deployed with frappe_docker. On top of what you have mentioned above, I've decided to perform more tests on different versions.

So far, I've tested different versions of the connector with ERPNext v14.92.5 and v15.91.0. However, I faced a broken instance every time with Internal Server Error in the browser and Module not found and some more exception messages in the logs.

Being said, I've started to suspect that it may be related to the architecture of the Docker deployment and will perform more debugging locally.

Could you please share how you deployed your instance initially and the latest updates on your side about this issue if you have any?

Best,
Can

[asieftejani]

@candemiralp did you use bench get-app inside docker?

[candemiralp]

Hello @asieftejani,

Thanks for checking this out. Yes, exactly! After playing around more, I just realized running bench get-app .. breaks the container as expected and I need to create a custom Docker image for the correct application installation and deployment.

I am following up this documentation to build it correctly at the moment and will drop an update soon.

Best,
Can

[candemiralp]

Hello again,

After building a custom image with apps.json, it worked like a charm.

Leaving the steps that I followed below for future refence.

1. Generate apps.json file in the frappe_docker root.

[
  {
    "url": "https://github.com/frappe/erpnext",
    "branch": "version-15"
  },
  {
    "url": "http://github.com/frappe/ecommerce_integrations/",
    "branch": "main"
  }
]

2. Build the custom Docker image in the same directory.

docker build \
 --build-arg=FRAPPE_PATH=https://github.com/frappe/frappe \
 --build-arg=FRAPPE_BRANCH=version-15 \
 --build-arg=APPS_JSON_BASE64=$(base64 -w 0 apps.json) \
 --tag=frappe-custom:15 \
 --file=images/layered/Containerfile .

3. Push the Docker image to Docker HUB following official documentation.
4. Define the following variables in your projects yaml file.

CUSTOM_IMAGE=YOUR_DOCKER_IMAGE
CUSTOM_TAG=YOUR_TAG

5. Deploy your instance following this guide.

Hope that helps!

Best,
Can

[asieftejani]

For docker, bench get-app does not work (immutable image and non-persistent volume)

Inside docker if you want to use bench commands (most of them at least) you can use https://github.com/rtCamp/Frappe-Manager

Otherwise if you want to learn the docker way use easy-install.py at frappe/frappe_docker#1640 (comment)