Skip to content

Document the post-sync URL override - #1241

Merged
ferschubert-hm merged 2 commits into
masterfrom
docs/post-sync-url
Sep 8, 2026
Merged

ferschubert-hm merged 2 commits into
masterfrom
docs/post-sync-url

Conversation

@ferschubert-hm

Copy link
Copy Markdown
Contributor

Documents the extra.altis.cloud.post-sync.{env}.url config added in humanmade/vantage-backend#2741.

Why

After a database sync, the cache flush and post-sync actions run against the destination environment's internal domain root. On subdirectory multisite installs the root is not always a registered site — if the main site lives under a path such as /blog/, WP-CLI cannot bootstrap WordPress there and those steps fail. The new config sets the URL explicitly per destination environment.

Changes

  • New docs/dashboard/post-sync-url.md — what the setting does, the composer.json shape, and the default behaviour when it is absent. Modelled on the existing search-replace.md page, since both are sync-time config read from composer.json at the deployed SHA and keyed by destination environment ID.
  • docs/dashboard/import-export.md — notes the override on the Run post-sync actions sync option and links to the new page.
  • docs/dashboard/search-replace.md — reciprocal link, as the two settings sit in the same composer.json block.

Note on ordering

The Vantage-side change (humanmade/vantage-backend#2741) is not merged yet. Worth holding this until it is, so the docs don't describe a setting that has no effect.

Adds docs for extra.altis.cloud.post-sync.{env}.url, which sets the site URL the post-sync cache flush and post-sync actions run against. Needed on subdirectory multisite installs where the internal domain root is not a registered site.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

@wisyhambolu wisyhambolu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, one nit.

Comment thread docs/dashboard/import-export.md Outdated
Co-authored-by: Wisdom Hambolu <wisdom@humanmade.com>
@ferschubert-hm
ferschubert-hm merged commit e7f7e16 into master Sep 8, 2026
1 of 3 checks passed
@ferschubert-hm
ferschubert-hm deleted the docs/post-sync-url branch September 8, 2026 12:32
@github-actions

Copy link
Copy Markdown

Git push to origin failed for v27-branch with exitcode 1

@github-actions

Copy link
Copy Markdown

Successfully created backport PR for v27-branch:

@github-actions

Copy link
Copy Markdown

Successfully created backport PR for v28-branch:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants