From a51da57b360ae86564e3501de9dfd41f6aaf8bbd Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Tue, 23 Jun 2026 11:11:18 +0530 Subject: [PATCH 01/14] feat(messaging): attach project ID to internal SMS for provider attribution (#12653) * feat(messaging): attach project ID to internal SMS for provider attribution Internal (auth) SMS such as phone OTP, MFA challenges and team invites are sent through Appwrite's own provider, but the provider's delivery logs and webhooks carry no way to trace a message back to the project that triggered it. Attach the project ID as the MSG91 UUID tracking field (supported via utopia-php/messaging 1.2.0) so provider-side reports can be reconciled per project. Bumps utopia-php/messaging 1.1.0 -> 1.2.0. * chore(messaging): require utopia-php/messaging ^1.2 The internal SMS path now depends on SMS::setMetadata() and the Msg91\MetadataParameter enum, both introduced in 1.2.0, so raise the constraint from ^1.1 to ^1.2 to enforce the minimum at install time. --- composer.json | 2 +- composer.lock | 14 +++++++------- src/Appwrite/Platform/Workers/Messaging.php | 5 +++++ 3 files changed, 13 insertions(+), 8 deletions(-) diff --git a/composer.json b/composer.json index 21432398af..2a1499f1a8 100644 --- a/composer.json +++ b/composer.json @@ -76,7 +76,7 @@ "utopia-php/locale": "0.8.*", "utopia-php/lock": "0.2.*", "utopia-php/logger": "0.8.*", - "utopia-php/messaging": "^1.1", + "utopia-php/messaging": "^1.2", "utopia-php/migration": "1.14.*", "utopia-php/platform": "^1.0@RC", "utopia-php/pools": "1.*", diff --git a/composer.lock b/composer.lock index d3bee71eb6..652b26e041 100644 --- a/composer.lock +++ b/composer.lock @@ -4,7 +4,7 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "2c365042d311895a9cddaceca7623b1e", + "content-hash": "508b3e633843d61eb24f864fd8832db0", "packages": [ { "name": "adhocore/jwt", @@ -4348,16 +4348,16 @@ }, { "name": "utopia-php/messaging", - "version": "1.1.0", + "version": "1.2.0", "source": { "type": "git", "url": "https://github.com/utopia-php/messaging.git", - "reference": "2a8e82cda89b373833e10923ae959f56466300a3" + "reference": "3419ffbbeb242b3232b588430bd465024959720c" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/utopia-php/messaging/zipball/2a8e82cda89b373833e10923ae959f56466300a3", - "reference": "2a8e82cda89b373833e10923ae959f56466300a3", + "url": "https://api.github.com/repos/utopia-php/messaging/zipball/3419ffbbeb242b3232b588430bd465024959720c", + "reference": "3419ffbbeb242b3232b588430bd465024959720c", "shasum": "" }, "require": { @@ -4394,9 +4394,9 @@ ], "support": { "issues": "https://github.com/utopia-php/messaging/issues", - "source": "https://github.com/utopia-php/messaging/tree/1.1.0" + "source": "https://github.com/utopia-php/messaging/tree/1.2.0" }, - "time": "2026-06-16T03:44:58+00:00" + "time": "2026-06-23T04:24:43+00:00" }, { "name": "utopia-php/migration", diff --git a/src/Appwrite/Platform/Workers/Messaging.php b/src/Appwrite/Platform/Workers/Messaging.php index 2a827f82cb..92745a0f91 100644 --- a/src/Appwrite/Platform/Workers/Messaging.php +++ b/src/Appwrite/Platform/Workers/Messaging.php @@ -33,6 +33,7 @@ use Utopia\Messaging\Adapter\SMS\GEOSMS; use Utopia\Messaging\Adapter\SMS\Inforu; use Utopia\Messaging\Adapter\SMS\Mock; use Utopia\Messaging\Adapter\SMS\Msg91; +use Utopia\Messaging\Adapter\SMS\Msg91\MetadataParameter; use Utopia\Messaging\Adapter\SMS\Telesign; use Utopia\Messaging\Adapter\SMS\TextMagic; use Utopia\Messaging\Adapter\SMS\Twilio; @@ -824,6 +825,10 @@ class Messaging extends Action ); $sms->setOrigin(MESSAGE_SEND_TYPE_INTERNAL); + // Attach the project ID so the SMS provider's delivery logs and + // webhooks can be attributed back to the originating project. + $sms->setMetadata([MetadataParameter::UUID->value => $project->getId()]); + $this->adapter->send($sms); } From 76e2baf3aa1f23780f3bbc260fb04bf249a7d686 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Tue, 23 Jun 2026 14:36:11 +0530 Subject: [PATCH 02/14] fix: purge project cache after config updates (#12654) --- .../Modules/Project/Http/Project/AuthMethods/Update.php | 1 + .../Platform/Modules/Project/Http/Project/OAuth2/Base.php | 5 ++++- .../Http/Project/Policies/MembershipPrivacy/Update.php | 1 + .../Http/Project/Policies/PasswordDictionary/Update.php | 1 + .../Project/Http/Project/Policies/PasswordHistory/Update.php | 1 + .../Http/Project/Policies/PasswordPersonalData/Update.php | 1 + .../Http/Project/Policies/PasswordStrength/Update.php | 1 + .../Project/Http/Project/Policies/SessionAlert/Update.php | 1 + .../Project/Http/Project/Policies/SessionDuration/Update.php | 1 + .../Http/Project/Policies/SessionInvalidation/Update.php | 1 + .../Project/Http/Project/Policies/SessionLimit/Update.php | 1 + .../Project/Http/Project/Policies/UserLimit/Update.php | 1 + .../Modules/Project/Http/Project/Protocols/Update.php | 1 + .../Platform/Modules/Project/Http/Project/SMTP/Update.php | 1 + .../Modules/Project/Http/Project/Services/Update.php | 1 + 15 files changed, 18 insertions(+), 1 deletion(-) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/AuthMethods/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/AuthMethods/Update.php index e98d3141f6..f5f0ae0a32 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/AuthMethods/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/AuthMethods/Update.php @@ -82,6 +82,7 @@ class Update extends Action $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), new Document([ 'auths' => $auths, ]))); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents->setParam('methodId', $methodId); diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/OAuth2/Base.php b/src/Appwrite/Platform/Modules/Project/Http/Project/OAuth2/Base.php index b5b8cacb73..b439e7fdf7 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/OAuth2/Base.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/OAuth2/Base.php @@ -425,7 +425,10 @@ abstract class Base extends Action 'oAuthProviders' => $oAuthProviders ]); - return $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); + + return $project; } public function action( diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/MembershipPrivacy/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/MembershipPrivacy/Update.php index 5d7043fedf..b167aba794 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/MembershipPrivacy/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/MembershipPrivacy/Update.php @@ -103,6 +103,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordDictionary/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordDictionary/Update.php index d7ee99fbfe..d0f8882e99 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordDictionary/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordDictionary/Update.php @@ -75,6 +75,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordHistory/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordHistory/Update.php index 84861a19e1..be611e299f 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordHistory/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordHistory/Update.php @@ -83,6 +83,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordPersonalData/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordPersonalData/Update.php index 435f00fc39..ff7819f192 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordPersonalData/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordPersonalData/Update.php @@ -76,6 +76,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordStrength/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordStrength/Update.php index 3fbcbe8b30..0f8c566511 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordStrength/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/PasswordStrength/Update.php @@ -103,6 +103,7 @@ class Update extends Action $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), new Document([ 'auths' => $auths, ]))); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionAlert/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionAlert/Update.php index 79653d46ad..d930fd89e7 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionAlert/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionAlert/Update.php @@ -75,6 +75,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionDuration/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionDuration/Update.php index 0a7f33218a..10eabb57cd 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionDuration/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionDuration/Update.php @@ -75,6 +75,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionInvalidation/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionInvalidation/Update.php index a1feb67346..d4d87edbba 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionInvalidation/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionInvalidation/Update.php @@ -75,6 +75,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionLimit/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionLimit/Update.php index 936a541249..93ae339b79 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionLimit/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/SessionLimit/Update.php @@ -81,6 +81,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/UserLimit/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/UserLimit/Update.php index 2b7e704853..b3f430b779 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/UserLimit/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Policies/UserLimit/Update.php @@ -81,6 +81,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents ->setParam('projectId', $project->getId()) diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Protocols/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Protocols/Update.php index bfc73802c8..e0e4477a3c 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Protocols/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Protocols/Update.php @@ -79,6 +79,7 @@ class Update extends Action $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), new Document([ 'apis' => $protocols, ]))); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents->setParam('protocolId', $protocolId); diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/SMTP/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/SMTP/Update.php index bf513f5dac..dd8a469d26 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/SMTP/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/SMTP/Update.php @@ -170,6 +170,7 @@ class Update extends Action ]); $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), $updates)); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $response->dynamic($project, Response::MODEL_PROJECT); } diff --git a/src/Appwrite/Platform/Modules/Project/Http/Project/Services/Update.php b/src/Appwrite/Platform/Modules/Project/Http/Project/Services/Update.php index 518eeb4c36..86ef67bb01 100644 --- a/src/Appwrite/Platform/Modules/Project/Http/Project/Services/Update.php +++ b/src/Appwrite/Platform/Modules/Project/Http/Project/Services/Update.php @@ -79,6 +79,7 @@ class Update extends Action $project = $authorization->skip(fn () => $dbForPlatform->updateDocument('projects', $project->getId(), new Document([ 'services' => $services, ]))); + $authorization->skip(fn () => $dbForPlatform->purgeCachedDocument('projects', $project->getId())); $queueForEvents->setParam('serviceId', $serviceId); From bb21c18ad319f2226d8804ceab764b55acbb5490 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:02:32 +0530 Subject: [PATCH 03/14] Prepare 1.9.5 release updates --- .agents/skills/self-hosted-release/SKILL.md | 139 +++++++++++++++++ .../self-hosted-release/agents/openai.yaml | 4 + .env | 140 +++++++++--------- app/views/install/compose.phtml | 2 +- docker-compose.override.yml | 3 +- docker-compose.yml | 24 +-- 6 files changed, 230 insertions(+), 82 deletions(-) create mode 100644 .agents/skills/self-hosted-release/SKILL.md create mode 100644 .agents/skills/self-hosted-release/agents/openai.yaml diff --git a/.agents/skills/self-hosted-release/SKILL.md b/.agents/skills/self-hosted-release/SKILL.md new file mode 100644 index 0000000000..989b8f4c1a --- /dev/null +++ b/.agents/skills/self-hosted-release/SKILL.md @@ -0,0 +1,139 @@ +--- +name: self-hosted-release +description: Enforce Appwrite self-hosted release readiness checks. Use when validating a self-hosted RC or final release, running fresh Docker Compose install tests, testing realistic e2e workflows, discovering the previous stable release baseline, upgrading seeded data from the previous self-hosted release, verifying migrations, compatibility filters, release metadata, installer behavior, or deciding whether a self-hosted release is safe to publish. +compatibility: Requires an Appwrite server repository checkout, Docker Compose, network access to fetch tags/images, and the normal Appwrite test environment. +--- + +# Self-Hosted Release + +## Purpose + +Use this skill as a release gate for Appwrite self-hosted RCs and final releases. Do not treat container health or metadata review as enough. A release is not ready until a fresh self-hosted stack works with realistic workflows and an upgrade from the previous stable self-hosted release preserves seeded data through migrations. + +## Release Context + +1. Confirm the current branch and target version: + - Check the branch name, `app/init/constants.php`, release notes, Docker image tags, and the user's stated target. + - If those disagree, stop and resolve the target version before validating. +2. Determine the previous stable self-hosted baseline automatically: + - Prefer remote tags so stale local tags do not mislead the gate. + - Use stable semver tags lower than the target version; ignore RC, beta, alpha, dev, and other prerelease tags. + - Pick the highest stable version lower than the target as the upgrade and compatibility baseline. + - Only ask the user for a baseline if no stable lower tag can be discovered or the target version is ambiguous. +3. Record the target version, target commit SHA, previous stable baseline, database adapter(s), Compose profile(s), and any release-specific risks before starting validation. + +Useful commands: + +```sh +git rev-parse --abbrev-ref HEAD +git rev-parse HEAD +rg -n "APP_VERSION_STABLE|APP_CACHE_BUSTER" app/init/constants.php +git ls-remote --tags origin "refs/tags/*" +``` + +## Fresh Install Gate + +Build and run the target release with the local Docker Compose stack, then test it like a real self-hosted install. + +1. Start from a clean stack and build the target: + +```sh +docker compose down -v +docker compose up -d --force-recreate --build --wait +docker compose exec -T appwrite vars +curl -fsS http://localhost/v1/health/version +``` + +2. Inspect runtime health before running tests: + - Check `docker compose ps` and `docker compose logs` for crash loops, missing env vars, failed mounts, worker failures, executor/runtime failures, migration errors, queue errors, and warnings that indicate broken self-hosted wiring. + - Verify required services are reachable through the public HTTP surface, not only from inside containers. + - If a route is advertised by specs, docs, install templates, or release notes, verify the route actually exists and returns the expected auth/validation behavior. + +3. Run the Appwrite test suite inside Docker: + +```sh +docker compose exec -T appwrite test /usr/src/code/tests/unit +docker compose exec -T appwrite test /usr/src/code/tests/e2e/General +docker compose exec -T appwrite sh -lc 'vendor/bin/paratest --processes "$(nproc)" /usr/src/code/tests/e2e/Services --exclude-group abuseEnabled --exclude-group screenshots' +``` + +When validating a risky release, broaden the matrix with the same database adapters and modes CI uses. At minimum, cover the default self-hosted adapter and every adapter touched by migrations, storage, query behavior, relationships, or installer changes. + +4. Exercise realistic workflows with real-ish data: + - Create console users, projects, API keys, platforms, webhooks, teams, memberships, and sessions. + - Create databases/tables/columns/indexes/relationships and rows with varied permissions, sizes, types, pagination, filters, and updates. + - Create storage buckets and files, then read, update, preview/download, and delete them through public APIs. + - Create and execute functions/sites when compute, runtimes, builds, domains, or executor behavior changed. + - Exercise messaging, realtime, domains, auth providers, abuse/rate-limit behavior, and background workers when they are in scope. + - Use public APIs and SDK-like calls wherever practical; direct database inspection is only supporting evidence. + +Block the release for any missing env var, broken container dependency, failing public route, unexpected 5xx, queue/worker failure, test failure, or workflow that only works with unrealistic empty data. + +## Upgrade Gate + +Validate upgrade from the previous stable self-hosted release to the target release using the same persisted volumes and configuration. + +1. Install the previous stable baseline: + - Use the discovered baseline tag/image, not a hardcoded version. + - Start with the documented self-hosted install path and a clean volume set. + - Confirm `/v1/health/version` reports the baseline version. + +2. Seed broad, realistic data on the baseline before upgrading: + - Include multiple projects, users, teams, memberships, API keys, sessions/tokens, databases/tables/rows, attributes, indexes, relationships, permissions, buckets, files, functions/sites, executions, webhooks, messaging/realtime resources, domains, and project settings as applicable. + - Include edge-shaped data that migrations commonly break: empty values, long strings, arrays, enums, relationships, large files, many rows, deleted/disabled resources, and mixed permissions. + - Capture enough IDs and API calls to verify the same resources after upgrade. + +3. Upgrade the baseline stack to the target release: + - Reuse the same volumes and configuration. + - Replace the Appwrite image/tag with the target release build. + - Run the documented upgrade path and required migration command(s). + - Capture logs for appwrite, workers, databases, redis, executor, and proxy services during the first boot. + +4. Verify migration behavior: + - Migration completes without fatal errors, partial failures, or skipped projects. + - Running the migration again is safe and idempotent. + - A failed or interrupted migration can be retried without data loss when that scenario is relevant to the changed migration. + - Existing volumes can be reused after restart. + +5. Verify seeded data after upgrade through public APIs: + - Fetch and mutate seeded projects, users, teams, permissions, rows, files, functions/sites, executions, domains, webhooks, messaging/realtime resources, and settings. + - Confirm indexes, relationships, file contents, execution history, auth/session behavior, and background worker side effects still work. + - Run focused e2e tests against the upgraded stack for every service touched by migration, compatibility, installer, or public API changes. + +Block the release for migration failure, non-idempotency, data loss, changed permissions, broken reads/writes on upgraded data, failed workers/queues after upgrade, or any behavior that only works on fresh installs. + +## Metadata And Compatibility Gate + +Review release metadata after the runtime gates, not instead of them: + +- `app/init/constants.php`: `APP_VERSION_STABLE` is the target version and `APP_CACHE_BUSTER` is incremented. +- `docker-compose.yml` and `app/views/install/compose.phtml`: Appwrite and console image tags are correct for the target release. +- `README.md` and `README-CN.md`: self-hosted install snippets use the target release. +- `src/Appwrite/Migration/Migration.php`: the target version maps to the correct migration class. +- `CHANGES.md`: the target version has user-facing notes for notable changes, fixes, migrations, compatibility notes, and self-hosted operator impact. +- Generated/public outputs are refreshed when API specs, SDKs, install templates, Docker Compose output, or metadata-driven docs changed. + +For public API changes, compare against the previous stable baseline: + +- Look for renamed/removed fields, new required inputs, enum changes, response model changes, status-code changes, route behavior changes, permission changes, and SDK-visible serialization changes. +- Request filters live in `src/Appwrite/Utopia/Request/Filters/V*.php`. +- Response filters live in `src/Appwrite/Utopia/Response/Filters/V*.php`. +- Filters must be registered in `app/controllers/general.php` for the correct `x-appwrite-response-format` boundary. +- Every compatibility filter needs focused unit coverage under `tests/unit/Utopia/Request/Filters` or `tests/unit/Utopia/Response/Filters`. +- Add service e2e coverage with `x-appwrite-response-format` when behavior depends on routing, auth, persistence, validation, or serialization. + +Block the release when a public breaking change lacks a compatibility filter and tests, unless the release owner explicitly accepts the break and documents it in release notes. + +## Release Decision + +Do not approve an RC or final self-hosted release until all gates pass: + +- Fresh install stack builds, starts, and survives realistic workflows. +- Full relevant tests pass inside Docker. +- No missing env vars, broken mounts, failed workers, broken routes, or unexplained runtime errors remain. +- Previous stable release is installed, seeded with broad data, upgraded to the target, migrated, restarted, and verified through public APIs. +- Migrations are complete, idempotent, retryable where relevant, and preserve seeded data. +- Compatibility filters and tests cover unintended public breaking changes. +- Version constants, image tags, install snippets, migration mapping, generated outputs, and changelog are current. + +For every RC/final validation, produce a short release evidence summary with: target version, commit SHA, previous stable baseline, tested database adapters and modes, fresh install scenarios, upgrade scenarios, seeded data categories, test commands and results, blockers found, fixes applied, and remaining owner-approved risks. diff --git a/.agents/skills/self-hosted-release/agents/openai.yaml b/.agents/skills/self-hosted-release/agents/openai.yaml new file mode 100644 index 0000000000..821102bce0 --- /dev/null +++ b/.agents/skills/self-hosted-release/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: "Self-Hosted Release" + short_description: "Validate Appwrite self-hosted release gates" + default_prompt: "Use $self-hosted-release to validate a fresh install and upgrade path for an Appwrite self-hosted release." diff --git a/.env b/.env index 57deb8cc0a..3c7c2a21ed 100644 --- a/.env +++ b/.env @@ -1,45 +1,39 @@ _APP_ENV=development _APP_EDITION=self-hosted _APP_LOCALE=en +_APP_OPENSSL_KEY_V1=your-secret-key +_APP_RULES_FORMAT=md5 +_APP_SYSTEM_RESPONSE_FORMAT= +_APP_TRUSTED_HEADERS=x-forwarded-for +_APP_POOL_ADAPTER=stack _APP_WORKER_PER_CORE=6 +_APP_WORKERS_NUM=1 +_APP_WORKER_MAX_COROUTINES=1 +_APP_WORKER_SCREENSHOTS_ROUTER=http://appwrite _APP_COMPRESSION_ENABLED=enabled _APP_COMPRESSION_MIN_SIZE_BYTES=1024 -_APP_CONSOLE_WHITELIST_ROOT=disabled -_APP_CONSOLE_WHITELIST_EMAILS= -_APP_CONSOLE_SESSION_ALERTS=enabled -_APP_CONSOLE_WHITELIST_IPS= -_APP_CONSOLE_COUNTRIES_DENYLIST=AQ -_APP_CONSOLE_HOSTNAMES=localhost,appwrite.io,*.appwrite.io -_APP_CONSOLE_SCHEMA=appwriteio -_APP_MIGRATION_HOST=appwrite -_APP_SYSTEM_EMAIL_NAME=Appwrite -_APP_SYSTEM_EMAIL_ADDRESS=noreply@appwrite.io -_APP_SYSTEM_TEAM_EMAIL=team@appwrite.io -_APP_EMAIL_SECURITY=security@appwrite.io -_APP_EMAIL_CERTIFICATES=certificates@appwrite.io -_APP_SYSTEM_RESPONSE_FORMAT= -_APP_CUSTOM_DOMAIN_DENY_LIST= -_APP_OPTIONS_ABUSE=disabled -_APP_OPTIONS_ROUTER_PROTECTION=disabled -_APP_OPTIONS_FORCE_HTTPS=disabled -_APP_OPTIONS_ROUTER_FORCE_HTTPS=disabled -_APP_OPENSSL_KEY_V1=your-secret-key -_APP_DNS=172.16.238.100 # CoreDNS _APP_DOMAIN=appwrite.test -_APP_CONSOLE_DOMAIN=localhost -_APP_CONSOLE_TRUSTED_PROJECTS=trusted-project,another-trusted-project _APP_DOMAIN_FUNCTIONS=functions.localhost _APP_DOMAIN_SITES=sites.localhost,rebranded.localhost -_APP_DOMAIN_TARGET_CNAME=cname.localhost _APP_DOMAIN_TARGET_A=203.0.0.1 _APP_DOMAIN_TARGET_AAAA=::1 _APP_DOMAIN_TARGET_CAA=digicert.com -_APP_RULES_FORMAT=md5 -_APP_REDIS_HOST=redis -_APP_REDIS_PORT=6379 -_APP_REDIS_PASS= -_APP_REDIS_USER= -COMPOSE_PROFILES=mariadb,mongodb,postgresql +_APP_DOMAIN_TARGET_CNAME=cname.localhost +_APP_CUSTOM_DOMAIN_DENY_LIST= +_APP_DNS=172.16.238.100 +_APP_OPTIONS_FORCE_HTTPS=disabled +_APP_OPTIONS_ROUTER_FORCE_HTTPS=disabled +_APP_OPTIONS_ROUTER_PROTECTION=disabled +_APP_OPTIONS_ABUSE=disabled +_APP_CONSOLE_DOMAIN=localhost +_APP_CONSOLE_HOSTNAMES=localhost,appwrite.io,*.appwrite.io +_APP_CONSOLE_SCHEMA=appwriteio +_APP_CONSOLE_SESSION_ALERTS=enabled +_APP_CONSOLE_TRUSTED_PROJECTS=trusted-project,another-trusted-project +_APP_CONSOLE_COUNTRIES_DENYLIST=AQ +_APP_CONSOLE_WHITELIST_EMAILS= +_APP_CONSOLE_WHITELIST_IPS= +_APP_CONSOLE_WHITELIST_ROOT=disabled _APP_DB_ADAPTER=mongodb _APP_DB_HOST=mongodb _APP_DB_PORT=27017 @@ -47,18 +41,27 @@ _APP_DB_SCHEMA=appwrite _APP_DB_USER=user _APP_DB_PASS=password _APP_DB_ROOT_PASS=rootsecretpassword -_APP_DATABASE_SHARED_TABLES= _APP_DATABASE_SHARED_NAMESPACE= +_APP_DATABASE_SHARED_TABLES= _APP_DB_ADAPTER_DOCUMENTSDB=mongodb _APP_DB_HOST_DOCUMENTSDB=mongodb _APP_DB_PORT_DOCUMENTSDB=27017 _APP_DB_ADAPTER_VECTORSDB=postgresql _APP_DB_HOST_VECTORSDB=postgresql _APP_DB_PORT_VECTORSDB=5432 -_APP_EMBEDDING_MODELS=nomic-embed-text +_APP_REDIS_HOST=redis +_APP_REDIS_PORT=6379 +_APP_REDIS_USER= +_APP_REDIS_PASS= _APP_EMBEDDING_ENDPOINT='http://appwrite-embedding:3000/embed' +_APP_EMBEDDING_MODELS=nomic-embed-text _APP_EMBEDDING_TIMEOUT=30000 _APP_STORAGE_DEVICE=Local +_APP_STORAGE_LIMIT=30000000 +_APP_STORAGE_PREVIEW_LIMIT=20000000 +_APP_STORAGE_ANTIVIRUS=disabled +_APP_STORAGE_ANTIVIRUS_HOST=clamav +_APP_STORAGE_ANTIVIRUS_PORT=3310 _APP_STORAGE_S3_ACCESS_KEY= _APP_STORAGE_S3_SECRET= _APP_STORAGE_S3_REGION=us-east-1 @@ -80,9 +83,11 @@ _APP_STORAGE_WASABI_ACCESS_KEY= _APP_STORAGE_WASABI_SECRET= _APP_STORAGE_WASABI_REGION=eu-central-1 _APP_STORAGE_WASABI_BUCKET= -_APP_STORAGE_ANTIVIRUS=disabled -_APP_STORAGE_ANTIVIRUS_HOST=clamav -_APP_STORAGE_ANTIVIRUS_PORT=3310 +_APP_SYSTEM_EMAIL_NAME=Appwrite +_APP_SYSTEM_EMAIL_ADDRESS=noreply@appwrite.io +_APP_SYSTEM_TEAM_EMAIL=team@appwrite.io +_APP_EMAIL_SECURITY=security@appwrite.io +_APP_EMAIL_CERTIFICATES=certificates@appwrite.io _APP_SMTP_HOST=maildev _APP_SMTP_PORT=1025 _APP_SMTP_SECURE= @@ -91,65 +96,58 @@ _APP_SMTP_PASSWORD=password _APP_SMS_PROVIDER=sms://username:password@mock _APP_SMS_FROM=+123456789 _APP_SMS_PROJECTS_DENY_LIST= -_APP_STORAGE_LIMIT=30000000 -_APP_STORAGE_PREVIEW_LIMIT=20000000 +_APP_MESSAGE_EMAIL_TEST_DSN= +_APP_MESSAGE_PUSH_TEST_DSN= +_APP_MESSAGE_SMS_TEST_DSN= _APP_COMPUTE_SIZE_LIMIT=30000000 -_APP_FUNCTIONS_TIMEOUT=900 -_APP_SITES_TIMEOUT=30 _APP_COMPUTE_BUILD_TIMEOUT=900 _APP_COMPUTE_CPUS=8 _APP_COMPUTE_MEMORY=8192 _APP_COMPUTE_INACTIVE_THRESHOLD=600 _APP_COMPUTE_MAINTENANCE_INTERVAL=600 _APP_COMPUTE_RUNTIMES_NETWORK=runtimes -_APP_EXECUTOR_SECRET=your-secret-key -_APP_EXECUTOR_HOST=http://exc1/v1 -_APP_BROWSER_HOST=http://appwrite-browser:3000/v1 _APP_FUNCTIONS_RUNTIMES=node-22 +_APP_FUNCTIONS_TIMEOUT=900 +_APP_FUNCTIONS_CREATION_ABUSE_LIMIT=5000 _APP_SITES_RUNTIMES=static-1,node-22 +_APP_SITES_TIMEOUT=30 +_APP_EXECUTOR_HOST=http://exc1/v1 +_APP_EXECUTOR_SECRET=your-secret-key +_APP_EXECUTOR_IMAGES=openruntimes/node:v5-22,openruntimes/static:v5-1 +_APP_BROWSER_HOST=http://appwrite-browser:3000/v1 +_APP_DOCKER_HUB_USERNAME= +_APP_DOCKER_HUB_PASSWORD= _APP_MAINTENANCE_INTERVAL=86400 _APP_MAINTENANCE_START_TIME=12:00 -_APP_MAINTENANCE_RETENTION_CACHE=2592000 -_APP_MAINTENANCE_RETENTION_EXECUTION=1209600 _APP_MAINTENANCE_RETENTION_ABUSE=86400 _APP_MAINTENANCE_RETENTION_AUDIT=1209600 _APP_MAINTENANCE_RETENTION_AUDIT_CONSOLE=15778800 -_APP_USAGE_AGGREGATION_INTERVAL=30 -_APP_STATS_RESOURCES_INTERVAL=30 -_APP_MAINTENANCE_RETENTION_USAGE_HOURLY=8640000 +_APP_MAINTENANCE_RETENTION_CACHE=2592000 +_APP_MAINTENANCE_RETENTION_EXECUTION=1209600 _APP_MAINTENANCE_RETENTION_SCHEDULES=86400 -_APP_INTERVAL_DOMAIN_VERIFICATION=120 +_APP_MAINTENANCE_RETENTION_USAGE_HOURLY=8640000 _APP_INTERVAL_CLEANUP_STALE_EXECUTIONS=300 +_APP_INTERVAL_DOMAIN_VERIFICATION=120 +_APP_USAGE_AGGREGATION_INTERVAL=30 _APP_USAGE_STATS=enabled -_APP_LOGGING_CONFIG= -_APP_LOGGING_CONFIG_REALTIME= +_APP_STATS_RESOURCES_INTERVAL=30 _APP_GRAPHQL_INTROSPECTION=enabled _APP_GRAPHQL_MAX_BATCH_SIZE=10 _APP_GRAPHQL_MAX_COMPLEXITY=250 _APP_GRAPHQL_MAX_DEPTH=4 -_APP_DOCKER_HUB_USERNAME= -_APP_DOCKER_HUB_PASSWORD= -_APP_VCS_GITHUB_APP_NAME= -_APP_VCS_GITHUB_PRIVATE_KEY=disabled -_APP_VCS_GITHUB_APP_ID= -_APP_VCS_GITHUB_CLIENT_ID= -_APP_VCS_GITHUB_CLIENT_SECRET= -_APP_VCS_GITHUB_WEBHOOK_SECRET= +_APP_ASSISTANT_OPENAI_API_KEY= +_APP_LOGGING_CONFIG= +_APP_LOGGING_CONFIG_REALTIME= +_APP_MIGRATION_HOST=appwrite _APP_MIGRATIONS_FIREBASE_CLIENT_ID= _APP_MIGRATIONS_FIREBASE_CLIENT_SECRET= -_APP_ASSISTANT_OPENAI_API_KEY= -_APP_MESSAGE_SMS_TEST_DSN= -_APP_MESSAGE_EMAIL_TEST_DSN= -_APP_MESSAGE_PUSH_TEST_DSN= -_APP_WEBHOOK_MAX_FAILED_ATTEMPTS=10 _APP_PROJECT_REGIONS=default -_APP_FUNCTIONS_CREATION_ABUSE_LIMIT=5000 -_APP_STATS_USAGE_DUAL_WRITING_DBS=database_db_main -_APP_TRUSTED_HEADERS=x-forwarded-for -_APP_POOL_ADAPTER=stack -_APP_WORKER_SCREENSHOTS_ROUTER=http://appwrite +_APP_VCS_GITHUB_APP_ID= +_APP_VCS_GITHUB_APP_NAME= +_APP_VCS_GITHUB_CLIENT_ID= +_APP_VCS_GITHUB_CLIENT_SECRET= +_APP_VCS_GITHUB_PRIVATE_KEY=disabled +_APP_VCS_GITHUB_WEBHOOK_SECRET= +_APP_WEBHOOK_MAX_FAILED_ATTEMPTS=10 _TESTS_OAUTH2_GITHUB_CLIENT_ID= _TESTS_OAUTH2_GITHUB_CLIENT_SECRET= - -_APP_WORKERS_NUM=1 -_APP_WORKER_MAX_COROUTINES=1 diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml index d04baa5e11..a7274d6e2b 100644 --- a/app/views/install/compose.phtml +++ b/app/views/install/compose.phtml @@ -1126,7 +1126,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); exec mongod --replSet rs0 --bind_ip_all --auth --keyFile "$$KEYFILE_PATH" healthcheck: test: | - mongosh -u root -p "$$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --quiet --eval "rs.status().ok" | grep -q 1 + mongosh -u root -p "$$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --quiet --eval "const hello = db.adminCommand({hello: 1}); if (!hello.isWritablePrimary) { quit(1); }" interval: 10s timeout: 10s retries: 10 diff --git a/docker-compose.override.yml b/docker-compose.override.yml index 29182f01d2..05e31ece94 100644 --- a/docker-compose.override.yml +++ b/docker-compose.override.yml @@ -16,7 +16,8 @@ services: ME_CONFIG_BASICAUTH_USERNAME: ${_APP_DB_USER} ME_CONFIG_BASICAUTH_PASSWORD: ${_APP_DB_PASS} depends_on: - - mongodb + mongodb: + condition: service_healthy adminer: image: adminer diff --git a/docker-compose.yml b/docker-compose.yml index 4341698653..e5b27fb5b1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1253,7 +1253,6 @@ services: restart: unless-stopped networks: - appwrite - - runtimes volumes: - /var/run/docker.sock:/var/run/docker.sock - appwrite-builds:/storage/builds:rw @@ -1265,7 +1264,7 @@ services: environment: - OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost - OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE= - - OPR_EXECUTOR_IMAGE_PULL=enabled + - OPR_EXECUTOR_IMAGES=$_APP_EXECUTOR_IMAGES - OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD - OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL - OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK @@ -1352,13 +1351,20 @@ services: healthcheck: test: | bash -c " - if mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval 'rs.status().ok' 2>/dev/null | grep -q 1; then - exit 0 - else - mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval \" - rs.initiate({_id: 'rs0', members: [{_id: 0, host: 'appwrite-mongodb:27017'}]}) - \" 2>/dev/null || exit 1 - fi + mongosh -u root -p ${_APP_DB_ROOT_PASS} --authenticationDatabase admin --quiet --eval \" + try { + const hello = db.adminCommand({hello: 1}); + if (hello.isWritablePrimary) { + quit(0); + } + } catch (e) {} + + try { + rs.initiate({_id: 'rs0', members: [{_id: 0, host: 'appwrite-mongodb:27017'}]}); + } catch (e) {} + + quit(1); + \" 2>/dev/null " interval: 10s timeout: 10s From 98c4845b69f3f41ba2be834436ce3b42fa8a9d7b Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:48:11 +0530 Subject: [PATCH 04/14] Fix installer compose release wiring --- app/views/install/compose.phtml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml index a7274d6e2b..b2061745b7 100644 --- a/app/views/install/compose.phtml +++ b/app/views/install/compose.phtml @@ -194,7 +194,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); appwrite-console: <<: *x-logging container_name: appwrite-console - image: /console:7.8.26 + image: /console:8 restart: unless-stopped networks: - appwrite @@ -1003,7 +1003,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); environment: - OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost - OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE= - - OPR_EXECUTOR_IMAGES= + - OPR_EXECUTOR_IMAGES= - OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD - OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL - OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK From 83ba5ee61eda363f82fc49c454142e41cae94627 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:49:56 +0530 Subject: [PATCH 05/14] Update console image to 8.7.5 --- app/views/install/compose.phtml | 2 +- docker-compose.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml index b2061745b7..220dac8172 100644 --- a/app/views/install/compose.phtml +++ b/app/views/install/compose.phtml @@ -194,7 +194,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); appwrite-console: <<: *x-logging container_name: appwrite-console - image: /console:8 + image: /console:8.7.5 restart: unless-stopped networks: - appwrite diff --git a/docker-compose.yml b/docker-compose.yml index e5b27fb5b1..7c8ca3a7c9 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -255,7 +255,7 @@ services: appwrite-console: <<: *x-logging container_name: appwrite-console - image: appwrite/console:8 + image: appwrite/console:8.7.5 restart: unless-stopped networks: - appwrite From bafa5380038b01bb75f3c38c2de289efa39995c0 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:52:35 +0530 Subject: [PATCH 06/14] Update README SDK lists --- README-CN.md | 22 +++++++++++++--------- README.md | 17 ++++++++++------- 2 files changed, 23 insertions(+), 16 deletions(-) diff --git a/README-CN.md b/README-CN.md index 212b5bb08d..8920e47aec 100644 --- a/README-CN.md +++ b/README-CN.md @@ -161,6 +161,8 @@ docker run -it --rm ` | | [PHP 快速开始](https://appwrite.io/docs/quick-starts/php) | | | [Kotlin 快速开始](https://appwrite.io/docs/quick-starts/kotlin) | | | [Swift 快速开始](https://appwrite.io/docs/quick-starts/swift) | +| | [Go 快速开始](https://appwrite.io/docs/quick-starts/go) | +| | [Rust 快速开始](https://appwrite.io/docs/quick-starts/rust) | ### 软件服务 @@ -185,20 +187,22 @@ docker run -it --rm ` - :white_check_mark:   [Web](https://github.com/appwrite/sdk-for-web) (由 Appwrite 团队维护) - :white_check_mark:   [Flutter](https://github.com/appwrite/sdk-for-flutter) (由 Appwrite 团队维护) -- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) - **公测** (由 Appwrite 团队维护) +- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) (由 Appwrite 团队维护) - :white_check_mark:   [Android](https://github.com/appwrite/sdk-for-android) (由 Appwrite 团队维护) +- :white_check_mark:   [React Native](https://github.com/appwrite/sdk-for-react-native) - **公测** (由 Appwrite 团队维护) #### 服务器 -- :white_check_mark:   [NodeJS](https://github.com/appwrite/sdk-for-node) (由 Appwrite 团队维护) -- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) (由 Appwrite 团队维护) -- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) - (由 Appwrite 团队维护) -- :white_check_mark:   [Deno](https://github.com/appwrite/sdk-for-deno) - **公测** (由 Appwrite 团队维护) -- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) (由 Appwrite 团队维护) +- :white_check_mark:   [Node.js](https://github.com/appwrite/sdk-for-node) (由 Appwrite 团队维护) - :white_check_mark:   [Python](https://github.com/appwrite/sdk-for-python) (由 Appwrite 团队维护) -- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) - **公测** (由 Appwrite 团队维护) -- :white_check_mark:   [Apple](https://github.com/appwrite/sdk-for-apple) - **公测** (由 Appwrite 团队维护) -- :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet) - **公测** (由 Appwrite 团队维护) +- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) (由 Appwrite 团队维护) +- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) (由 Appwrite 团队维护) +- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) (由 Appwrite 团队维护) +- :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet) (由 Appwrite 团队维护) +- :white_check_mark:   [Go](https://github.com/appwrite/sdk-for-go) (由 Appwrite 团队维护) +- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift) (由 Appwrite 团队维护) +- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) (由 Appwrite 团队维护) +- :white_check_mark:   [Rust](https://github.com/appwrite/sdk-for-rust) (由 Appwrite 团队维护) #### 开发者社区 diff --git a/README.md b/README.md index 88d527f060..8bcad82564 100644 --- a/README.md +++ b/README.md @@ -166,6 +166,8 @@ Getting started with Appwrite is as easy as creating a new project, choosing you | | [Quick start for PHP](https://appwrite.io/docs/quick-starts/php) | | | [Quick start for Kotlin](https://appwrite.io/docs/quick-starts/kotlin) | | | [Quick start for Swift](https://appwrite.io/docs/quick-starts/swift) | +| | [Quick start for Go](https://appwrite.io/docs/quick-starts/go) | +| | [Quick start for Rust](https://appwrite.io/docs/quick-starts/rust) | ### SDKs @@ -181,15 +183,16 @@ Below is a list of currently supported platforms and languages. If you would lik #### Server -- :white_check_mark:   [NodeJS](https://github.com/appwrite/sdk-for-node) -- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) -- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) -- :white_check_mark:   [Deno](https://github.com/appwrite/sdk-for-deno) -- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) +- :white_check_mark:   [Node.js](https://github.com/appwrite/sdk-for-node) - :white_check_mark:   [Python](https://github.com/appwrite/sdk-for-python) -- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) -- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift) +- :white_check_mark:   [Dart](https://github.com/appwrite/sdk-for-dart) +- :white_check_mark:   [PHP](https://github.com/appwrite/sdk-for-php) +- :white_check_mark:   [Ruby](https://github.com/appwrite/sdk-for-ruby) - :white_check_mark:   [.NET](https://github.com/appwrite/sdk-for-dotnet) +- :white_check_mark:   [Go](https://github.com/appwrite/sdk-for-go) +- :white_check_mark:   [Swift](https://github.com/appwrite/sdk-for-swift) +- :white_check_mark:   [Kotlin](https://github.com/appwrite/sdk-for-kotlin) +- :white_check_mark:   [Rust](https://github.com/appwrite/sdk-for-rust) Looking for more SDKs? - Help us by contributing a pull request to our [SDK Generator](https://github.com/appwrite/sdk-generator)! From fb3858c8c099fce205ad96e3e27f7f1795f4a7e1 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:58:50 +0530 Subject: [PATCH 07/14] Fix installer database and secret key UI --- app/views/install/compose.phtml | 2 +- app/views/install/installer.phtml | 2 +- app/views/install/installer/js/modules/context.js | 4 ++-- app/views/install/installer/js/steps.js | 4 ++-- app/views/install/installer/templates/steps/step-1.phtml | 2 +- app/views/install/installer/templates/steps/step-2.phtml | 2 +- app/views/install/installer/templates/steps/step-4.phtml | 2 +- 7 files changed, 9 insertions(+), 9 deletions(-) diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml index 220dac8172..7170439c1e 100644 --- a/app/views/install/compose.phtml +++ b/app/views/install/compose.phtml @@ -14,7 +14,7 @@ $image = $this->getParam('image', ''); $enableAssistant = $this->getParam('enableAssistant', false); $executorImages = $this->getParam('executorImages', ''); $dbService = $this->getParam('database', 'mongodb'); -$allowedDbServices = ['mariadb', 'mongodb']; +$allowedDbServices = ['mariadb', 'mongodb', 'postgresql']; if (!\in_array($dbService, $allowedDbServices, true)) { $dbService = 'mongodb'; } diff --git a/app/views/install/installer.phtml b/app/views/install/installer.phtml index d33838c8c6..7130a16f30 100644 --- a/app/views/install/installer.phtml +++ b/app/views/install/installer.phtml @@ -9,7 +9,7 @@ $defaultAppDomain = ($defaultAppDomain === 'traefik') ? 'localhost' : $defaultAp $defaultEmailCertificates = $defaultEmailCertificates ?? ''; $defaultDatabase = $vars['_APP_DB_ADAPTER']['default'] ?? 'mongodb'; $lockedDatabase = $isUpgrade && empty($lockedDatabase) ? $defaultDatabase : $lockedDatabase; -$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb', 'postgresql']; +$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb']; $isLocalInstall = $isLocalInstall ?? false; diff --git a/app/views/install/installer/js/modules/context.js b/app/views/install/installer/js/modules/context.js index 6f215da899..36b85a3843 100644 --- a/app/views/install/installer/js/modules/context.js +++ b/app/views/install/installer/js/modules/context.js @@ -4,8 +4,8 @@ const getLockedDatabase = () => getBodyDataset().lockedDatabase || ''; const getEnabledDatabases = () => { const raw = getBodyDataset().enabledDatabases; - if (!raw) return ['mongodb', 'mariadb', 'postgresql']; - try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb', 'postgresql']; } + if (!raw) return ['mongodb', 'mariadb']; + try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb']; } }; const STEP_IDS = Object.freeze({ diff --git a/app/views/install/installer/js/steps.js b/app/views/install/installer/js/steps.js index b34389b561..d5ee3dcb60 100644 --- a/app/views/install/installer/js/steps.js +++ b/app/views/install/installer/js/steps.js @@ -432,11 +432,11 @@ const secretKey = root?.querySelector('#secret-key'); const secretValue = secretKey?.value.trim() || ''; if (!secretKey || !secretValue) { - setFieldError?.(secretKey, 'Please enter or generate a secret API key'); + setFieldError?.(secretKey, 'Please enter or generate a secret key'); return false; } if (secretValue.length > 64) { - setFieldError?.(secretKey, 'Secret API key must be 1-64 characters'); + setFieldError?.(secretKey, 'Secret key must be 1-64 characters'); return false; } } diff --git a/app/views/install/installer/templates/steps/step-1.phtml b/app/views/install/installer/templates/steps/step-1.phtml index 8f4a726158..c02a669c63 100644 --- a/app/views/install/installer/templates/steps/step-1.phtml +++ b/app/views/install/installer/templates/steps/step-1.phtml @@ -7,7 +7,7 @@ $defaultHttpsPort = $defaultHttpsPort ?? '443'; $defaultEmailCertificates = $defaultEmailCertificates ?? ''; $defaultAssistantOpenAIKey = $defaultAssistantOpenAIKey ?? ''; $defaultDatabase = $defaultDatabase ?? 'mongodb'; -$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb', 'postgresql']; +$enabledDatabases = $enabledDatabases ?? ['mongodb', 'mariadb']; $selectedDatabase = $lockedDatabase ?: $defaultDatabase; $isDatabaseLocked = !empty($lockedDatabase); $mongoEnabled = in_array('mongodb', $enabledDatabases, true); diff --git a/app/views/install/installer/templates/steps/step-2.phtml b/app/views/install/installer/templates/steps/step-2.phtml index 9b7eed11b1..f0610e6295 100644 --- a/app/views/install/installer/templates/steps/step-2.phtml +++ b/app/views/install/installer/templates/steps/step-2.phtml @@ -27,7 +27,7 @@ $secretKeyValue = htmlspecialchars((string) $defaultSecretKey, ENT_QUOTES, 'UTF-
- +
-
Secret API key
+
Secret key
From f477f4e22109b4128b46dfb4c301a7e946b39ebd Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 12:59:24 +0530 Subject: [PATCH 08/14] Simplify installer template defaults --- app/views/install/installer.phtml | 16 ++++++++-------- .../installer/templates/steps/step-1.phtml | 18 +++++++++--------- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/app/views/install/installer.phtml b/app/views/install/installer.phtml index 7130a16f30..d5e4383f48 100644 --- a/app/views/install/installer.phtml +++ b/app/views/install/installer.phtml @@ -1,16 +1,16 @@ Date: Wed, 24 Jun 2026 13:08:30 +0530 Subject: [PATCH 09/14] Restore PostgreSQL installer defaults --- app/views/install/installer.phtml | 2 +- app/views/install/installer/js/modules/context.js | 4 ++-- app/views/install/installer/templates/steps/step-1.phtml | 2 +- src/Appwrite/Platform/Installer/Runtime/Config.php | 2 +- src/Appwrite/Platform/Tasks/Install.php | 4 ++-- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/app/views/install/installer.phtml b/app/views/install/installer.phtml index d5e4383f48..2de92fd3f3 100644 --- a/app/views/install/installer.phtml +++ b/app/views/install/installer.phtml @@ -9,7 +9,7 @@ $defaultAppDomain = ($defaultAppDomain === 'traefik') ? 'localhost' : $defaultAp $defaultEmailCertificates ??= ''; $defaultDatabase = $vars['_APP_DB_ADAPTER']['default'] ?? 'mongodb'; $lockedDatabase = $isUpgrade && empty($lockedDatabase) ? $defaultDatabase : $lockedDatabase; -$enabledDatabases ??= ['mongodb', 'mariadb']; +$enabledDatabases ??= ['mongodb', 'mariadb', 'postgresql']; $isLocalInstall ??= false; diff --git a/app/views/install/installer/js/modules/context.js b/app/views/install/installer/js/modules/context.js index 36b85a3843..6f215da899 100644 --- a/app/views/install/installer/js/modules/context.js +++ b/app/views/install/installer/js/modules/context.js @@ -4,8 +4,8 @@ const getLockedDatabase = () => getBodyDataset().lockedDatabase || ''; const getEnabledDatabases = () => { const raw = getBodyDataset().enabledDatabases; - if (!raw) return ['mongodb', 'mariadb']; - try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb']; } + if (!raw) return ['mongodb', 'mariadb', 'postgresql']; + try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb', 'postgresql']; } }; const STEP_IDS = Object.freeze({ diff --git a/app/views/install/installer/templates/steps/step-1.phtml b/app/views/install/installer/templates/steps/step-1.phtml index e7d356745b..cfd02819bb 100644 --- a/app/views/install/installer/templates/steps/step-1.phtml +++ b/app/views/install/installer/templates/steps/step-1.phtml @@ -7,7 +7,7 @@ $defaultHttpsPort ??= '443'; $defaultEmailCertificates ??= ''; $defaultAssistantOpenAIKey ??= ''; $defaultDatabase ??= 'mongodb'; -$enabledDatabases ??= ['mongodb', 'mariadb']; +$enabledDatabases ??= ['mongodb', 'mariadb', 'postgresql']; $selectedDatabase = $lockedDatabase ?: $defaultDatabase; $isDatabaseLocked = !empty($lockedDatabase); $mongoEnabled = in_array('mongodb', $enabledDatabases, true); diff --git a/src/Appwrite/Platform/Installer/Runtime/Config.php b/src/Appwrite/Platform/Installer/Runtime/Config.php index 6142e47152..53479a00f0 100644 --- a/src/Appwrite/Platform/Installer/Runtime/Config.php +++ b/src/Appwrite/Platform/Installer/Runtime/Config.php @@ -27,7 +27,7 @@ final class Config private bool $isLocal = false; private ?string $hostPath = null; private ?string $lockedDatabase = null; - private array $enabledDatabases = ['mongodb', 'mariadb']; + private array $enabledDatabases = ['mongodb', 'mariadb', 'postgresql']; private array $vars = []; public function __construct(array $values = []) diff --git a/src/Appwrite/Platform/Tasks/Install.php b/src/Appwrite/Platform/Tasks/Install.php index 75f3c5bf18..70a6135901 100644 --- a/src/Appwrite/Platform/Tasks/Install.php +++ b/src/Appwrite/Platform/Tasks/Install.php @@ -199,7 +199,7 @@ class Install extends Action } $installerConfig = $this->readInstallerConfig(); - $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb']; + $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb', 'postgresql']; if (!in_array($database, $enabledDatabases, true)) { Console::error("Database '{$database}' is not available. Available options: " . implode(', ', $enabledDatabases)); Console::exit(1); @@ -331,7 +331,7 @@ class Install extends Action $state->clearStaleLock(); $installerConfig = $this->readInstallerConfig(); - $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb']; + $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb', 'postgresql']; $this->setInstallerConfig([ 'defaultHttpPort' => $defaultHttpPort, From 67af7528199f4f96ca6df6f10beb32db3e11f243 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 13:16:45 +0530 Subject: [PATCH 10/14] Update installer config default database tests --- .../Platform/Modules/Installer/Runtime/ConfigTest.php | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php b/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php index 7f0faafcbc..a539ae9b12 100644 --- a/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php +++ b/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php @@ -22,7 +22,7 @@ final class ConfigTest extends TestCase $this->assertFalse($config->isLocal()); $this->assertNull($config->getHostPath()); $this->assertNull($config->getLockedDatabase()); - $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); $this->assertEmpty($config->getVars()); } @@ -439,7 +439,7 @@ final class ConfigTest extends TestCase $this->assertFalse($array['isLocal']); $this->assertNull($array['hostPath']); $this->assertNull($array['lockedDatabase']); - $this->assertEquals(['mongodb', 'mariadb'], $array['enabledDatabases']); + $this->assertEquals(['mongodb', 'mariadb', 'postgresql'], $array['enabledDatabases']); } public function testMultipleApplyCallsAccumulate(): void @@ -494,10 +494,10 @@ final class ConfigTest extends TestCase public function testDefaultEnabledDatabases(): void { $config = new Config(); - $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); $this->assertTrue($config->isDatabaseEnabled('mongodb')); $this->assertTrue($config->isDatabaseEnabled('mariadb')); - $this->assertFalse($config->isDatabaseEnabled('postgresql')); + $this->assertTrue($config->isDatabaseEnabled('postgresql')); } public function testSetEnabledDatabases(): void @@ -535,7 +535,7 @@ final class ConfigTest extends TestCase { $config = new Config(); $config->apply(['enabledDatabases' => 'mongodb']); - $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); } public function testEnabledDatabasesInToArray(): void From 6a6741137c6dd7804207f9505e9a7dfb52dc7c9c Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 13:22:45 +0530 Subject: [PATCH 11/14] Keep PostgreSQL disabled by default in installer --- app/views/install/installer.phtml | 2 +- app/views/install/installer/js/modules/context.js | 4 ++-- .../install/installer/templates/steps/step-1.phtml | 2 +- src/Appwrite/Platform/Installer/Runtime/Config.php | 2 +- src/Appwrite/Platform/Tasks/Install.php | 13 +++++++++---- .../Modules/Installer/Runtime/ConfigTest.php | 10 +++++----- 6 files changed, 19 insertions(+), 14 deletions(-) diff --git a/app/views/install/installer.phtml b/app/views/install/installer.phtml index 2de92fd3f3..d5e4383f48 100644 --- a/app/views/install/installer.phtml +++ b/app/views/install/installer.phtml @@ -9,7 +9,7 @@ $defaultAppDomain = ($defaultAppDomain === 'traefik') ? 'localhost' : $defaultAp $defaultEmailCertificates ??= ''; $defaultDatabase = $vars['_APP_DB_ADAPTER']['default'] ?? 'mongodb'; $lockedDatabase = $isUpgrade && empty($lockedDatabase) ? $defaultDatabase : $lockedDatabase; -$enabledDatabases ??= ['mongodb', 'mariadb', 'postgresql']; +$enabledDatabases ??= ['mongodb', 'mariadb']; $isLocalInstall ??= false; diff --git a/app/views/install/installer/js/modules/context.js b/app/views/install/installer/js/modules/context.js index 6f215da899..36b85a3843 100644 --- a/app/views/install/installer/js/modules/context.js +++ b/app/views/install/installer/js/modules/context.js @@ -4,8 +4,8 @@ const getLockedDatabase = () => getBodyDataset().lockedDatabase || ''; const getEnabledDatabases = () => { const raw = getBodyDataset().enabledDatabases; - if (!raw) return ['mongodb', 'mariadb', 'postgresql']; - try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb', 'postgresql']; } + if (!raw) return ['mongodb', 'mariadb']; + try { return JSON.parse(raw); } catch (e) { return ['mongodb', 'mariadb']; } }; const STEP_IDS = Object.freeze({ diff --git a/app/views/install/installer/templates/steps/step-1.phtml b/app/views/install/installer/templates/steps/step-1.phtml index cfd02819bb..e7d356745b 100644 --- a/app/views/install/installer/templates/steps/step-1.phtml +++ b/app/views/install/installer/templates/steps/step-1.phtml @@ -7,7 +7,7 @@ $defaultHttpsPort ??= '443'; $defaultEmailCertificates ??= ''; $defaultAssistantOpenAIKey ??= ''; $defaultDatabase ??= 'mongodb'; -$enabledDatabases ??= ['mongodb', 'mariadb', 'postgresql']; +$enabledDatabases ??= ['mongodb', 'mariadb']; $selectedDatabase = $lockedDatabase ?: $defaultDatabase; $isDatabaseLocked = !empty($lockedDatabase); $mongoEnabled = in_array('mongodb', $enabledDatabases, true); diff --git a/src/Appwrite/Platform/Installer/Runtime/Config.php b/src/Appwrite/Platform/Installer/Runtime/Config.php index 53479a00f0..6142e47152 100644 --- a/src/Appwrite/Platform/Installer/Runtime/Config.php +++ b/src/Appwrite/Platform/Installer/Runtime/Config.php @@ -27,7 +27,7 @@ final class Config private bool $isLocal = false; private ?string $hostPath = null; private ?string $lockedDatabase = null; - private array $enabledDatabases = ['mongodb', 'mariadb', 'postgresql']; + private array $enabledDatabases = ['mongodb', 'mariadb']; private array $vars = []; public function __construct(array $values = []) diff --git a/src/Appwrite/Platform/Tasks/Install.php b/src/Appwrite/Platform/Tasks/Install.php index 70a6135901..adaedd9427 100644 --- a/src/Appwrite/Platform/Tasks/Install.php +++ b/src/Appwrite/Platform/Tasks/Install.php @@ -102,6 +102,8 @@ class Install extends Action $envFileExists = file_exists($this->path . '/' . $this->getEnvFileName()); $existingInstallation = $data !== '' || $envFileExists; + $existingDatabase = null; + if ($existingInstallation) { $time = \time(); $composeFileName = $this->getComposeFileName(); @@ -171,7 +173,6 @@ class Install extends Action // Detect database type from existing installation. // 1.9.0+ installs have _APP_DB_ADAPTER; pre-1.9.0 installs // can be detected by the DB service name or _APP_DB_HOST. - $existingDatabase = null; foreach ($compose->getServices() as $service) { $svcEnv = $service->getEnvironment()->list(); if (isset($svcEnv['_APP_DB_ADAPTER'])) { @@ -199,8 +200,9 @@ class Install extends Action } $installerConfig = $this->readInstallerConfig(); - $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb', 'postgresql']; - if (!in_array($database, $enabledDatabases, true)) { + $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb']; + $isExistingDatabase = $isUpgrade && $existingDatabase !== null && $database === $existingDatabase; + if (!in_array($database, $enabledDatabases, true) && !$isExistingDatabase) { Console::error("Database '{$database}' is not available. Available options: " . implode(', ', $enabledDatabases)); Console::exit(1); } @@ -331,7 +333,10 @@ class Install extends Action $state->clearStaleLock(); $installerConfig = $this->readInstallerConfig(); - $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb', 'postgresql']; + $enabledDatabases = $installerConfig['enabledDatabases'] ?? ['mongodb', 'mariadb']; + if ($isUpgrade && $lockedDatabase !== null && !in_array($lockedDatabase, $enabledDatabases, true)) { + $enabledDatabases[] = $lockedDatabase; + } $this->setInstallerConfig([ 'defaultHttpPort' => $defaultHttpPort, diff --git a/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php b/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php index a539ae9b12..7f0faafcbc 100644 --- a/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php +++ b/tests/unit/Platform/Modules/Installer/Runtime/ConfigTest.php @@ -22,7 +22,7 @@ final class ConfigTest extends TestCase $this->assertFalse($config->isLocal()); $this->assertNull($config->getHostPath()); $this->assertNull($config->getLockedDatabase()); - $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); $this->assertEmpty($config->getVars()); } @@ -439,7 +439,7 @@ final class ConfigTest extends TestCase $this->assertFalse($array['isLocal']); $this->assertNull($array['hostPath']); $this->assertNull($array['lockedDatabase']); - $this->assertEquals(['mongodb', 'mariadb', 'postgresql'], $array['enabledDatabases']); + $this->assertEquals(['mongodb', 'mariadb'], $array['enabledDatabases']); } public function testMultipleApplyCallsAccumulate(): void @@ -494,10 +494,10 @@ final class ConfigTest extends TestCase public function testDefaultEnabledDatabases(): void { $config = new Config(); - $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); $this->assertTrue($config->isDatabaseEnabled('mongodb')); $this->assertTrue($config->isDatabaseEnabled('mariadb')); - $this->assertTrue($config->isDatabaseEnabled('postgresql')); + $this->assertFalse($config->isDatabaseEnabled('postgresql')); } public function testSetEnabledDatabases(): void @@ -535,7 +535,7 @@ final class ConfigTest extends TestCase { $config = new Config(); $config->apply(['enabledDatabases' => 'mongodb']); - $this->assertSame(['mongodb', 'mariadb', 'postgresql'], $config->getEnabledDatabases()); + $this->assertSame(['mongodb', 'mariadb'], $config->getEnabledDatabases()); } public function testEnabledDatabasesInToArray(): void From 9df27901d640ea47144cc606591244c26b207437 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Wed, 24 Jun 2026 14:03:23 +0530 Subject: [PATCH 12/14] Disable PostgreSQL for fresh CLI installs --- src/Appwrite/Platform/Tasks/Install.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Appwrite/Platform/Tasks/Install.php b/src/Appwrite/Platform/Tasks/Install.php index adaedd9427..8c9b86dedb 100644 --- a/src/Appwrite/Platform/Tasks/Install.php +++ b/src/Appwrite/Platform/Tasks/Install.php @@ -57,7 +57,7 @@ class Install extends Action ->param('image', 'appwrite', new Text(0), 'Main appwrite docker image', true) ->param('interactive', 'Y', new Text(1), 'Run an interactive session', true) ->param('no-start', false, new Boolean(true), 'Run an interactive session', true) - ->param('database', 'mongodb', new WhiteList(['mongodb', 'mariadb', 'postgresql']), 'Database to use (mongodb|mariadb|postgresql)', true) + ->param('database', 'mongodb', new WhiteList(['mongodb', 'mariadb']), 'Database to use (mongodb|mariadb)', true) ->callback($this->action(...)); } From 8d711e1db6e789da7d6e8bba08a1973df5545949 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Fri, 26 Jun 2026 08:05:36 +0530 Subject: [PATCH 13/14] Enable Open Runtimes NFT pruning config --- .env | 1 + app/config/variables.php | 9 +++++++++ app/views/install/compose.phtml | 4 +++- docker-compose.yml | 4 +++- .../Platform/Modules/Functions/Workers/Builds.php | 2 ++ 5 files changed, 18 insertions(+), 2 deletions(-) diff --git a/.env b/.env index 3c7c2a21ed..35f5f135bc 100644 --- a/.env +++ b/.env @@ -106,6 +106,7 @@ _APP_COMPUTE_MEMORY=8192 _APP_COMPUTE_INACTIVE_THRESHOLD=600 _APP_COMPUTE_MAINTENANCE_INTERVAL=600 _APP_COMPUTE_RUNTIMES_NETWORK=runtimes +_APP_OPEN_RUNTIMES_NFT=enabled _APP_FUNCTIONS_RUNTIMES=node-22 _APP_FUNCTIONS_TIMEOUT=900 _APP_FUNCTIONS_CREATION_ABUSE_LIMIT=5000 diff --git a/app/config/variables.php b/app/config/variables.php index 90df9b4518..b77d841aaf 100644 --- a/app/config/variables.php +++ b/app/config/variables.php @@ -1070,6 +1070,15 @@ return [ 'question' => '', 'filter' => '' ], + [ + 'name' => '_APP_OPEN_RUNTIMES_NFT', + 'description' => 'Enables dependency tracing for Open Runtimes build artifacts. When enabled, supported SSR site builds prune unused node_modules files before packaging the build output.', + 'introduction' => '1.9.0', + 'default' => 'enabled', + 'required' => false, + 'question' => '', + 'filter' => '' + ], [ 'name' => '_APP_DOCKER_HUB_USERNAME', 'description' => 'The username for hub.docker.com. This variable is used to pull images from hub.docker.com.', diff --git a/app/views/install/compose.phtml b/app/views/install/compose.phtml index 7170439c1e..4f910be9e1 100644 --- a/app/views/install/compose.phtml +++ b/app/views/install/compose.phtml @@ -457,6 +457,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); - _APP_COMPUTE_BUILD_TIMEOUT - _APP_COMPUTE_CPUS - _APP_COMPUTE_MEMORY + - _APP_OPEN_RUNTIMES_NFT - _APP_COMPUTE_SIZE_LIMIT - _APP_OPTIONS_FORCE_HTTPS - _APP_OPTIONS_ROUTER_FORCE_HTTPS @@ -1004,7 +1005,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); - OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost - OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE= - OPR_EXECUTOR_IMAGES= - - OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD + - OPR_EXECUTOR_INACTIVE_THRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD - OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL - OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK - OPR_EXECUTOR_DOCKER_HUB_USERNAME=$_APP_DOCKER_HUB_USERNAME @@ -1013,6 +1014,7 @@ $hostPath = rtrim($this->getParam('hostPath', ''), '/'); - OPR_EXECUTOR_RUNTIMES=$_APP_FUNCTIONS_RUNTIMES,$_APP_SITES_RUNTIMES - OPR_EXECUTOR_SECRET=$_APP_EXECUTOR_SECRET - OPR_EXECUTOR_RUNTIME_VERSIONS=v5 + - OPEN_RUNTIMES_NFT=$_APP_OPEN_RUNTIMES_NFT - OPR_EXECUTOR_LOGGING_CONFIG=$_APP_LOGGING_CONFIG - OPR_EXECUTOR_STORAGE_DEVICE=$_APP_STORAGE_DEVICE - OPR_EXECUTOR_STORAGE_S3_ACCESS_KEY=$_APP_STORAGE_S3_ACCESS_KEY diff --git a/docker-compose.yml b/docker-compose.yml index 7c8ca3a7c9..5793af4a60 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -560,6 +560,7 @@ services: - _APP_COMPUTE_BUILD_TIMEOUT - _APP_COMPUTE_CPUS - _APP_COMPUTE_MEMORY + - _APP_OPEN_RUNTIMES_NFT - _APP_COMPUTE_SIZE_LIMIT - _APP_OPTIONS_FORCE_HTTPS - _APP_OPTIONS_ROUTER_FORCE_HTTPS @@ -1265,7 +1266,7 @@ services: - OPR_EXECUTOR_CONNECTION_STORAGE=local://localhost - OPR_EXECUTOR_CONNECTION_BUILD_CACHE_STORAGE= - OPR_EXECUTOR_IMAGES=$_APP_EXECUTOR_IMAGES - - OPR_EXECUTOR_INACTIVE_TRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD + - OPR_EXECUTOR_INACTIVE_THRESHOLD=$_APP_COMPUTE_INACTIVE_THRESHOLD - OPR_EXECUTOR_MAINTENANCE_INTERVAL=$_APP_COMPUTE_MAINTENANCE_INTERVAL - OPR_EXECUTOR_NETWORK=$_APP_COMPUTE_RUNTIMES_NETWORK - OPR_EXECUTOR_DOCKER_HUB_USERNAME=$_APP_DOCKER_HUB_USERNAME @@ -1274,6 +1275,7 @@ services: - OPR_EXECUTOR_RUNTIMES=$_APP_FUNCTIONS_RUNTIMES,$_APP_SITES_RUNTIMES - OPR_EXECUTOR_SECRET=$_APP_EXECUTOR_SECRET - OPR_EXECUTOR_RUNTIME_VERSIONS=v5 + - OPEN_RUNTIMES_NFT=$_APP_OPEN_RUNTIMES_NFT - OPR_EXECUTOR_LOGGING_CONFIG=$_APP_LOGGING_CONFIG - OPR_EXECUTOR_STORAGE_DEVICE=$_APP_STORAGE_DEVICE - OPR_EXECUTOR_STORAGE_S3_ACCESS_KEY=$_APP_STORAGE_S3_ACCESS_KEY diff --git a/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php b/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php index 2550db36e2..eb23453b1e 100644 --- a/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php +++ b/src/Appwrite/Platform/Modules/Functions/Workers/Builds.php @@ -662,6 +662,7 @@ class Builds extends Action 'APPWRITE_FUNCTION_RUNTIME_VERSION' => $runtime['version'] ?? '', 'APPWRITE_FUNCTION_CPUS' => $cpus, 'APPWRITE_FUNCTION_MEMORY' => $memory, + 'OPEN_RUNTIMES_NFT' => System::getEnv('_APP_OPEN_RUNTIMES_NFT', 'enabled'), ]; break; case 'sites': @@ -677,6 +678,7 @@ class Builds extends Action 'APPWRITE_SITE_RUNTIME_VERSION' => $runtime['version'] ?? '', 'APPWRITE_SITE_CPUS' => $cpus, 'APPWRITE_SITE_MEMORY' => $memory, + 'OPEN_RUNTIMES_NFT' => System::getEnv('_APP_OPEN_RUNTIMES_NFT', 'enabled'), ]; break; } From 2dc2358c998fd6428634a78eb02ee2fae7347974 Mon Sep 17 00:00:00 2001 From: Chirag Aggarwal Date: Fri, 26 Jun 2026 08:13:51 +0530 Subject: [PATCH 14/14] chore: remove sunset SDK entries --- app/config/sdks.php | 18 -------- docs/sdks/deno/CHANGELOG.md | 29 ------------ docs/sdks/deno/GETTING_STARTED.md | 68 ---------------------------- docs/sdks/flutter-dev/CHANGELOG.md | 66 --------------------------- docs/sdks/flutter-dev/EXAMPLES.md | 63 -------------------------- docs/sdks/objective-c/CHANGELOG.md | 1 - src/Appwrite/Platform/Tasks/SDKs.php | 8 ---- 7 files changed, 253 deletions(-) delete mode 100644 docs/sdks/deno/CHANGELOG.md delete mode 100644 docs/sdks/deno/GETTING_STARTED.md delete mode 100644 docs/sdks/flutter-dev/CHANGELOG.md delete mode 100644 docs/sdks/flutter-dev/EXAMPLES.md delete mode 100644 docs/sdks/objective-c/CHANGELOG.md diff --git a/app/config/sdks.php b/app/config/sdks.php index f3d89db3c2..8d128cfe0c 100644 --- a/app/config/sdks.php +++ b/app/config/sdks.php @@ -95,24 +95,6 @@ return [ 'gitBranch' => 'dev', 'changelog' => \realpath(__DIR__ . '/../../docs/sdks/apple/CHANGELOG.md'), ], - [ - 'key' => 'objective-c', - 'name' => 'Objective C', - 'url' => '', - 'package' => '', - 'enabled' => false, - 'beta' => false, - 'dev' => false, - 'hidden' => false, - 'family' => APP_SDK_PLATFORM_CLIENT, - 'prism' => '', - 'source' => false, - 'gitUrl' => 'git@github.com:appwrite/sdk-for-objective-c.git', - 'gitRepoName' => 'sdk-for-objective-c', - 'gitUserName' => 'appwrite', - 'gitBranch' => 'dev', - 'changelog' => \realpath(__DIR__ . '/../../docs/sdks/objective-c/CHANGELOG.md'), - ], [ 'key' => 'android', 'name' => 'Android', diff --git a/docs/sdks/deno/CHANGELOG.md b/docs/sdks/deno/CHANGELOG.md deleted file mode 100644 index 4319fb6d59..0000000000 --- a/docs/sdks/deno/CHANGELOG.md +++ /dev/null @@ -1,29 +0,0 @@ -# Change Log - -## 16.0.0 - -* Add array-based enum parameters (e.g., `permissions: BrowserPermission[]`). -* Breaking change: `Output` enum has been removed; use `ImageFormat` instead. -* Add `getQueueAudits` support to `Health` service. -* Add longtext/mediumtext/text/varchar attribute and column helpers to `Databases` and `TablesDB` services. - -## 15.1.0 - -* Add `incrementDocumentAttribute` and `decrementDocumentAttribute` support to `Databases` service -* Add `gif` support to `ImageFormat` enum -* Add `dart38` and `flutter332` support to runtime models -* Add `encrypt` support to `StringAttribute` model -* Add `sequence` support to `Document` model -* Add `upsertDocument` support to `Databases` service - -## 15.0.0 - -* Add `` to doc examples due to the new multi region endpoints -* Add doc examples and methods for bulk api transactions: `createDocuments`, `deleteDocuments` etc. -* Add doc examples, class and methods for new `Sites` service -* Add doc examples, class and methods for new `Tokens` service -* Add enums for `BuildRuntime `, `Adapter`, `Framework`, `DeploymentDownloadType` and `VCSDeploymentType` -* Updates enum for `runtimes` with Pythonml312, Dart219, Flutter327 and Flutter329 -* Add `token` param to `getFilePreview` and `getFileView` for File tokens usage -* Add `queries` and `search` params to `listMemberships` method -* Removes `search` param from `listExecutions` method \ No newline at end of file diff --git a/docs/sdks/deno/GETTING_STARTED.md b/docs/sdks/deno/GETTING_STARTED.md deleted file mode 100644 index 5046d61c74..0000000000 --- a/docs/sdks/deno/GETTING_STARTED.md +++ /dev/null @@ -1,68 +0,0 @@ -## Getting Started - -### Init your SDK - -Initialize your SDK with your Appwrite server API endpoint and project ID which can be found in your project settings page and your new API secret Key from project's API keys section. - -```typescript -let client = new sdk.Client(); - -client - .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint - .setProject('5df5acd0d48c2') // Your project ID - .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key - .setSelfSigned() // Use only on dev mode with a self-signed SSL cert -; -``` - -### Make your first request - -Once your SDK object is set, create any of the Appwrite service objects and choose any request to send. Full documentation for any service method you would like to use can be found in your SDK documentation or in the [API References](https://appwrite.io/docs) section. - -```typescript -let users = new sdk.Users(client); - -let user = await users.create(ID.unique(), "email@example.com", "+123456789", "password", "Walter O'Brien"); -console.log(user); -``` - -### Full Example - -```typescript -import * as sdk from "https://deno.land/x/appwrite/mod.ts"; - -let client = new sdk.Client(); -let users = new sdk.Users(client); - -client - .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint - .setProject('5df5acd0d48c2') // Your project ID - .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key - .setSelfSigned() // Use only on dev mode with a self-signed SSL cert -; - -let user = await users.create(ID.unique(), "email@example.com", "+123456789", "password", "Walter O'Brien"); -console.log(user); -``` - -### Error Handling - -The Appwrite Deno SDK raises `AppwriteException` object with `message`, `code` and `response` properties. You can handle any errors by catching `AppwriteException` and present the `message` to the user or handle it yourself based on the provided error information. Below is an example. - -```typescript -let users = new sdk.Users(client); - -try { - let user = await users.create(ID.unique(), "email@example.com", "+123456789", "password", "Walter O'Brien"); -} catch(e) { - console.log(e.message); -} -``` - -### Learn more - -You can use the following resources to learn more and get help -- 🚀 [Getting Started Tutorial](https://appwrite.io/docs/getting-started-for-server) -- 📜 [Appwrite Docs](https://appwrite.io/docs) -- 💬 [Discord Community](https://appwrite.io/discord) -- 🚂 [Appwrite Deno Playground](https://github.com/appwrite/playground-for-deno) diff --git a/docs/sdks/flutter-dev/CHANGELOG.md b/docs/sdks/flutter-dev/CHANGELOG.md deleted file mode 100644 index 9b6bb58c41..0000000000 --- a/docs/sdks/flutter-dev/CHANGELOG.md +++ /dev/null @@ -1,66 +0,0 @@ -## 0.3.2 - -- Fixed package namespaces -- Breaking change: `Output` enum has been removed; use `ImageFormat` instead. -- Add `Channel` helpers for Realtime. - -## 0.3.1 - -- Downgraded meta package version to 1.1.8 - -## 0.3.0 - -- Updated package dependencies (@lohanidamodar) -- Added Flutter for Web compatibility (@lohanidamodar) - -## 0.2.3 - -- Fixed OAuth2 cookie bug, where a new session cookie couldn't overwrite an old cookie - -## 0.2.2 - -- Fixed an error that happened when the OAuth session creation request was sent before any other API call -- Fixed a bug in the Avatars service where location URL generation had syntax error - -## 0.2.1 - -- Fixed callback scheme - -## 0.2.0 - -- Updated flutter_web_auth plugin to version 0.2.4 -- Added per project unique callback for OAuth2 redirects to avoid conflicts between multiple Appwrite projects - -## 0.1.1 - -- Updated flutter_web_auth version - -## 0.1.0 - -- Added examples file -- Some minor style fixes - -## 0.0.14 - -- Using MultipartFile for file uploads - -## 0.0.13 - -- Fix for file upload method - -## 0.0.12 - -- Added file upload support for storage service - -## 0.0.11 - -- Added integration with web auth plugin to support Appwrite OAuth API - -## 0.0.9 - -- Updated default params - -## 0.0.8 - -- Fixed compilation error in Client class -- Shorter description for package diff --git a/docs/sdks/flutter-dev/EXAMPLES.md b/docs/sdks/flutter-dev/EXAMPLES.md deleted file mode 100644 index d0cb0c2b2a..0000000000 --- a/docs/sdks/flutter-dev/EXAMPLES.md +++ /dev/null @@ -1,63 +0,0 @@ -# Examples - -Init your Appwrite client: - -```dart -Client client = Client(); - -client - .setEndpoint('https://localhost/v1') // Your Appwrite Endpoint - .setProject('5e8cf4f46b5e8') // Your project ID - .setSelfSigned() // Remove in production -; -``` - -Create a new user and session: - -```dart -Account account = Account(client); - -final user = await account.create(userId: ID.unique(), email: "email@example.com", password: "password", name: "Walter O'Brien"); - -final session = await account.createEmailSession(email: 'me@appwrite.io', password: 'password'); - -``` - -Fetch user profile: - -```dart -Account account = Account(client); - -final profile = await account.get(); -``` - -Upload File: - -```dart -Storage storage = Storage(client); - -late InputFile file; - -if(kIsWeb) { - file = InputFile(bytes: pickedFile.bytes, filename: 'image.jpg'); -} else { - file = InputFile(path: './path-to-file/image.jpg', filename: 'image.jpg'); -} - -storage.createFile( - bucketId: '[BUCKET_ID]', - fileId: '[FILE_ID]', // use 'unique()' to automatically generate a unique ID - file: file, - permissions: [ - Permission.read(Role.any()), - ], -) -.then((response) { - print(response); // File uploaded! -}) -.catchError((error) { - print(error.response); -}); -``` - -All examples and API features are available at the [official Appwrite docs](https://appwrite.io/docs) diff --git a/docs/sdks/objective-c/CHANGELOG.md b/docs/sdks/objective-c/CHANGELOG.md deleted file mode 100644 index 420e6f23d0..0000000000 --- a/docs/sdks/objective-c/CHANGELOG.md +++ /dev/null @@ -1 +0,0 @@ -# Change Log diff --git a/src/Appwrite/Platform/Tasks/SDKs.php b/src/Appwrite/Platform/Tasks/SDKs.php index b3802b8eac..30b355d8ae 100644 --- a/src/Appwrite/Platform/Tasks/SDKs.php +++ b/src/Appwrite/Platform/Tasks/SDKs.php @@ -10,7 +10,6 @@ use Appwrite\SDK\Language\CLI; use Appwrite\SDK\Language\CodexPlugin; use Appwrite\SDK\Language\CursorPlugin; use Appwrite\SDK\Language\Dart; -use Appwrite\SDK\Language\Deno; use Appwrite\SDK\Language\DotNet; use Appwrite\SDK\Language\Flutter; use Appwrite\SDK\Language\Go; @@ -389,9 +388,6 @@ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND $warning = $warning . "\n\n > This is the Node.js SDK for integrating with Appwrite from your Node.js server-side code. If you're looking to integrate from the browser, you should check [appwrite/sdk-for-web](https://github.com/appwrite/sdk-for-web)"; break; - case 'deno': - $config = new Deno(); - break; case 'python': $config = new Python(); $config->setPipPackage('appwrite'); @@ -409,10 +405,6 @@ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND $config = new ReactNative(); $config->setNPMPackage('react-native-appwrite'); break; - case 'flutter-dev': - $config = new Flutter(); - $config->setPackageName('appwrite_dev'); - break; case 'dart': $config = new Dart(); $config->setPackageName('dart_appwrite');