docs(console): self-hosted 2.6.0, 2.6.1, 1.9.8 and 1.9.9 releases by ChiragAgg5k · Pull Request #14731 · appwrite/appwrite · GitHub
Skip to content

docs(console): self-hosted 2.6.0, 2.6.1, 1.9.8 and 1.9.9 releases - #14731

Open
ChiragAgg5k wants to merge 9 commits into
mainfrom
docs/release-2.6.0
Open

ChiragAgg5k wants to merge 9 commits into
mainfrom
docs/release-2.6.0

Conversation

@ChiragAgg5k

@ChiragAgg5k ChiragAgg5k commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

Prepare self-hosting docs for Appwrite 2.6.0 and 2.6.1, and for the 1.9.8 and 1.9.9 maintenance releases on the legacy line.

2.6.0 and 1.9.8

  • Update installation examples, generated Compose, database/environment docs and SDK compatibility rows for 2.6.0.
  • Include the 1.9.8 upgrade instructions and compatibility rows. Keep Console 8.7.37 for the legacy line, and publish installer port 20080 in its upgrade command.
  • Use a single security changelog entry (2026-10-21-1) covering patched eMudhra trust in both releases and the SVG sanitizer/cache update in 1.9.8. Link to each version's upgrade instructions and full GitHub release notes.
  • Keep the complete bundled changes in the GitHub release notes. The changelog notes that 2.6.0 includes schema updates and requires migration.
  • Fix the release helper's quote-sensitive version parser.

2.6.1 and 1.9.9

2.6.1 (#14745) and 1.9.9 (#14747) are precautionary maintenance releases that move the runtime to PHP 8.5.12. PHP 8.5.12 fixes CVE-2026-109618 and CVE-2026-109619 ("PHP2Shell"). Appwrite is not affected by either one, because it serves requests through Swoole rather than PHP's web SAPIs (mod_php, PHP-FPM, CGI).

  • Install snippets (installation and databases pages), the example tag and generated Compose (composeData.ts) move to 2.6.1, via bun run release:self-hosted 2.6.1 --appwrite=<release/2.6.1 checkout>. The Compose diff is the image tag and VITE_APPWRITE_VERSION only.
  • The latest upgrade section becomes "Upgrading to 2.6.1" (one step from 1.9.6 or later, per Migration::$versions). It explains the precautionary PHP update, that from 2.6.0 only the images change, and keeps the 2.6.0 notes (schema changes, ExifTool, S3 path style, eMudhra) for anyone coming from 2.5.x or earlier. 2.6.0 joins the skipped-release links.
  • The 1.9 section moves to 1.9.9 by hand, as docs(console): self-hosted 2.6.0, 2.6.1, 1.9.8 and 1.9.9 releases #14731 did for 1.9.8: one step from 1.9.8 (images only), and from 1.9.6/1.9.7 it also brings the 1.9.8 security fixes. Console stays at 8.7.37.
  • The 1.9.x minor-upgrade example now reads 1.9.5 → 1.9.9 → 2.6.1.
  • SDK compatibility rows: 2.6.1 copies 2.6.0's rows and 1.9.9 copies 1.9.8's, in both tables.
  • New changelog entry 2026-10-21-2 for 2.6.1 and 1.9.9, linking the PHP advisories, both GitHub releases and both upgrade sections. Like the security entry, it has no cover and uses the generated title share image.
  • Environment variables: unchanged. Neither release adds, removes or changes a variable (the 2.6.1 diff from 2.6.0 is the base image, version constant, READMEs and migration map).

Remaining 2.6.0/1.9.8 mentions are intentional: compatibility rows, the skipped-release link, the 2.6.0 schema note, the 1.9.8 fixes note and the security changelog entry.

Merge order

2.6.0 and 1.9.8 are published; 2.6.1 and 1.9.9 are not yet tagged or published. Merge this docs PR after 2.6.1 and 1.9.9 are published and the 2.6.x versioned specs have been generated; the 2.6.x API-reference pin (release:self-hosted --specs) and the final SDK compatibility review are still pending that step.

Validation

  • All 12 generated Compose combinations (three databases × two worker topologies × AutoGravity on/off) pass docker compose config --quiet with the 2.6.1 data.
  • Prettier passes on composeData.ts and the new changelog entry; lint:content passes.
  • Dev server: /changelog/entry/2026-10-21-2, /changelog, /docs/advanced/self-hosting/installation and /docs/advanced/self-hosting/production/updates return HTTP 200 and render the 2.6.1 and 1.9.9 content.

Related server releases: #14730, #14726, #14745, #14747. Release-gate fixes for 2.6.0: #14737.

Screenshots

2.6.1 and 1.9.9 changelog entry:

2.6.1 and 1.9.9 changelog entry, light

2.6.1 and 1.9.9 changelog entry, dark

Upgrading to 2.6.1:

Upgrading to 2.6.1, light

Upgrading to 2.6.1, dark

Upgrading within the 1.9 line (1.9.9):

Upgrading to 1.9.9, light

Upgrading to 1.9.9, dark

Earlier captures, before the 2.6.1/1.9.9 update (the combined security entry is unchanged; the two upgrade sections are now superseded by the ones above):

Combined security changelog

Appwrite 2.6.0 upgrade instructions, before 2.6.1

Appwrite 1.9.8 upgrade instructions, before 1.9.9

Related: appwrite-labs/cloud#6671

@tenki-reviewer

tenki-reviewer Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

@appwrite

appwrite Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

New Console

Project ID: new-console

Sites (1)
Site Status Logs Preview QR
 New Console
new-console
Processing Processing View Logs Preview URL QR Code

Tip

JWT tokens let functions act on behalf of users while preserving their permissions

@ChiragAgg5k ChiragAgg5k self-assigned this Oct 21, 2026
@hansi-codes

hansi-codes Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

🟢 Tier S · Ready to merge

The reviewed incremental documentation changes are consistent with the stated release updates and have no actionable defects.

Updates self-hosted release documentation and generated Compose data across the 2.6.x and legacy 1.9.x lines. It adds installation, SDK compatibility, environment-variable, and upgrade guidance for 2.6.0/1.9.8 and the PHP 8.5.12 maintenance releases 2.6.1/1.9.9, with corresponding security changelog entries. The release helper also accepts either quote style for the Compose version literal.

Latest changes: The latest commits add the PHP 8.5.12 maintenance-release changelog for 2.6.1 and 1.9.9, and update installation, SDK compatibility, upgrade, and generated Compose references to 2.6.1.

Verdict New comments Fixed Still open
✅ Approved 0 0 0
📂 Walkthrough · 8
File Change
apps/console/scripts/release-self-hosted.ts Makes the Compose version parser handle single- and double-quoted version values.
apps/console/src/content/changelog/entries/2026-10-21-1.markdoc Documents the eMudhra trust updates and 1.9.8 SVG sanitizer/cache changes for the 2.6.0 and 1.9.8 releases.
apps/console/src/content/changelog/entries/2026-10-21-2.markdoc Announces the PHP 8.5.12 maintenance releases 2.6.1 and 1.9.9, with upgrade links and migration notes.
apps/console/src/content/docs/advanced/self-hosting/configuration/databases/index.markdoc Updates database installation examples to Appwrite 2.6.1.
apps/console/src/content/docs/advanced/self-hosting/configuration/environment-variables/index.markdoc Documents the environment variables introduced for Appwrite 2.6.0.
apps/console/src/content/docs/advanced/self-hosting/installation/index.markdoc Updates installation examples and SDK compatibility rows for Appwrite 2.6.0, 2.6.1, 1.9.8, and 1.9.9.
apps/console/src/content/docs/advanced/self-hosting/production/updates/index.markdoc Adds and revises upgrade guidance for the 2.6.x and 1.9.x releases, including their migration and security notes.
apps/console/src/lib/docs/compose-generator/composeData.ts Regenerates Compose generator data with the Appwrite 2.6.1 and matching Console versions.

Reviewed the commits since 8140d49 · Details · Comment @hansi-codes review to re-run, or mention @hansi-codes with a question.

@hansi-codes hansi-codes Bot 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.

🔵 Tier A · See the inline comments. Summary

@ChiragAgg5k ChiragAgg5k mentioned this pull request Oct 21, 2026
6 tasks
@ChiragAgg5k ChiragAgg5k changed the title docs(console): Appwrite 2.6.0 release docs(console): self-hosted security updates for 2.6.0 and 1.9.8 Oct 21, 2026
@ChiragAgg5k

Copy link
Copy Markdown
Member Author

@hansi-codes hansi-codes Bot 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.

🟢 Tier S · Looks good to merge. Summary

@hansi-codes hansi-codes Bot 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.

🟢 Tier S · Looks good to merge. Summary

@ChiragAgg5k ChiragAgg5k changed the title docs(console): self-hosted security updates for 2.6.0 and 1.9.8 docs(console): self-hosted 2.6.0, 2.6.1, 1.9.8 and 1.9.9 releases Oct 21, 2026

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants