Fix or extend an installed ExApp
ExApps are open source and run from Docker images, so any installed ExApp can be changed locally without waiting for a release: get the source at the installed version, change it, rebuild the image, and make the instance run the rebuilt one. The user's part is one sentence ("add EuroLLM support to llm2", "llm2 never reports progress, fix it"); this skill is the loop the agent executes on their behalf.
How to work
Read references/exapp-ai-maintenance.md in full and execute its
numbered runbook: identify what is running, clone the source at the INSTALLED tag, diagnose, patch, bump the
version, rebuild under the original image name, registry-map the daemon to local images, update with
--info-xml, verify. It ends with a worked example (adding the EuroLLM model to llm2, verified end to end)
and a symptom-first troubleshooting table.
Ground rules
- Never use
--rm-data; the app's data volume and configuration belong to the user. - Fix what is running: check out the tag matching the installed version, not the moving main branch.
- Bump
<version>with a FOURTH segment (2.8.0becomes2.8.0.1): it sorts above the installed release but below upstream's next patch, so a future store update takes over cleanly. An unbumped rebuild never deploys; same-versionapp:updateis a verified no-op. - Keep
<image-tag>equal to<version>; AppAPI deploys<image-tag>whileapp:updatecompares<version>. - Registry mappings are daemon-wide. On a shared daemon, remove the mapping right after the update.
- Finish with verification the user can see (the feature works,
app:listshows the new version), and offer to upstream the change; local rebuilds are for immediacy, upstream is the fix.
Files
- references/exapp-ai-maintenance.md: the eight-step runbook, the EuroLLM worked example, return-to-stock instructions, troubleshooting.
- Redeploy semantics in a development setting: exapp-development. Lifecycle command reference: exapp-operations.