diff --git a/README.md b/README.md
index bebcba9..1a53494 100644
--- a/README.md
+++ b/README.md
@@ -167,7 +167,7 @@ Defaults:
 
 When no `--version-file` flag is provided, `vociferate` derives the current version from the most recent released section heading in the changelog (`## [x.y.z] - ...`). If no prior releases exist, it defaults to `0.0.0` and recommends `v1.0.0` as the first tag.
 
-During prepare, vociferate can normalize changelog heading links when it can determine the repository URL (from CI environment variables or `origin` git remote). If you prefer changelog headings to stay plain while tags are being rebuilt, leave the changelog as plain headings and avoid retaining historical release-tag links.
+During prepare, vociferate can normalize changelog heading links when it can determine the repository URL (from CI environment variables or `origin` git remote). If your runner injects an internal host (for example `http://teapot:3000`) into `GITHUB_SERVER_URL`, set `VOCIFERATE_REPOSITORY_URL` at the server/runner level to force the canonical external URL used for changelog links.
 
 When running `--version`, the `release-version` file is created automatically if it does not exist, so new repositories do not need to pre-seed it.
 
diff --git a/changelog.md b/changelog.md
index 9e12854..ef1579a 100644
--- a/changelog.md
+++ b/changelog.md
@@ -25,6 +25,7 @@ A `### Breaking` section is used in addition to Keep a Changelog's standard sect
 - First-release recommendation remains `v1.0.0` when no prior releases exist in the changelog.
 - Do Release smoke validation now expects `--recommend` to fail on tagged release checkouts where `Unreleased` is intentionally empty.
 - Changelog reference links now use compare URLs (`previous...current` for releases and `latest...main` for Unreleased), with first release links comparing from the repository's first commit short hash.
+- Repository URL derivation now supports `VOCIFERATE_REPOSITORY_URL` as the highest-priority override for changelog link generation.
 
 ## [0.1.0] - 2026-03-20