odysseus/docs/wilkensxl-build.md

WilkensXL build versioning

Odysseus keeps the upstream application version separate from the local WilkensXL build version.

• APP_VERSION and UPSTREAM_VERSION track the upstream release.
• BUILD_VERSION and FULL_VERSION identify this custom image.
• /api/version returns both values so Dockge, logs, and the UI can show which build is running.

The default custom build is:

1.0.1-wilkensxl.2

The value can be overridden at runtime with:

• ODYSSEUS_BUILD_FLAVOR
• ODYSSEUS_BUILD_REVISION
• ODYSSEUS_BUILD_VERSION

Update workflow

When upstream publishes a new Odysseus version:

1. Merge or rebase the upstream changes into the WilkensXL branch.
2. Keep the addon loader small and stable.
3. Put local behavior changes into addons wherever possible.
4. Run the addon, integration, readiness, and version metadata tests.
5. Bump BUILD_REVISION or set ODYSSEUS_BUILD_VERSION for the new image.

The loader does not remove all porting work, but it reduces it. Most local behavior should live behind addon manifests, so future upstream updates only need the loader compatibility checked plus any addons that touch changed internals.

Optional image extras

The Docker image skips the optional Real-ESRGAN wheel prebuild by default. That keeps normal CI and Dockge updates from blocking on optional Gallery upscaling dependencies.

To include the prebuilt Real-ESRGAN helper wheels in a custom image, build with:

--build-arg PREBUILD_REALESRGAN_WHEELS=true