The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
Update copy RE disk configuration changes and cooldown (#50844)
Joshen Limfea8b8b41d7f
diff --git a/apps/docs/content/guides/platform/compute-and-disk.mdx b/apps/docs/content/guides/platform/compute-and-disk.mdxindex d425676ec42..66c8694561a 100644--- a/apps/docs/content/guides/platform/compute-and-disk.mdx+++ b/apps/docs/content/guides/platform/compute-and-disk.mdx@@ -166,5 +166,5 @@ As mentioned in the Postgres [documentation](https://postgresqlco.nf/doc/en/para### Constraints-- You can modify disk attributes up to **four times** within a rolling 24-hour window. A new modification can be initiated as soon as the previous one completes. If you reach this limit, you will encounter throttling and must wait for the rolling 24-hour window to permit further adjustments.+- After **any** disk attribute change, there is a cooldown period of approximately four hours before you can make further adjustments. During this time, no changes are allowed. If you encounter throttling, you’ll need to wait until the cooldown period concludes before making additional modifications.- You can increase disk size but cannot decrease it.diff --git a/apps/docs/content/guides/platform/database-size.mdx b/apps/docs/content/guides/platform/database-size.mdxindex 0e1f1b0dab5..bf8532ebd3d 100644--- a/apps/docs/content/guides/platform/database-size.mdx+++ b/apps/docs/content/guides/platform/database-size.mdx@@ -87,9 +87,7 @@ Supabase uses network-attached storage to balance performance with scalability.Projects on the Pro Plan and higher have auto-scaling disks.-Disk size expands automatically when the database reaches 90% of the allocated disk size. The disk is expanded to be 50% larger (for example, 8 GB -> 12 GB).--Auto-scaling is limited to four modifications within a rolling 24-hour window. While a new modification can be initiated immediately after the previous one completes, reaching the quota of four resizes within the current rolling 24-hour window will prevent further scaling until the window allows it. If you reach 95% disk utilization and have exhausted your modification quota, your project will enter read-only mode.+Disk size expands automatically when the database reaches 90% of the allocated disk size. The disk is expanded to be 50% larger (for example, 8 GB -> 12 GB). Auto-scaling is limited to four modifications within a rolling 24-hour window. If you reach 95% disk utilization and have exhausted your modification quota, your project will enter read-only mode.<Admonition type="note">@@ -103,7 +101,7 @@ Disk size can also be manually expanded on the [Database Settings page](/dashboaYou may want to import a lot of data into your database which requires multiple disk expansions. for example, uploading more than 1.5x the current size of your database storage will put your database into [read-only mode](#read-only-mode). If so, it is highly recommended you increase the disk size manually on the [Database Settings page](/dashboard/project/_/database/settings).-Due to restrictions on the underlying cloud provider, disk modifications are limited to four operations within a rolling 24-hour window. While a new modification can be initiated as soon as the previous one completes, you will be unable to make further adjustments if you reach this rolling 24-hour limit until the rolling 24-hour window permits it.+Due to restrictions on the underlying cloud provider, disk expansions can occur only once every four hours. During the four hour cool down window, the disk cannot be resized again.</Admonition>diff --git a/apps/docs/content/troubleshooting/high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process.mdx b/apps/docs/content/troubleshooting/high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process.mdxindex 95a5ec2db0b..d417d49d841 100644--- a/apps/docs/content/troubleshooting/high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process.mdx+++ b/apps/docs/content/troubleshooting/high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process.mdx@@ -50,7 +50,7 @@ Since the wraparound prevention autovacuum cannot be stopped, the best approach2. **Increase Disk Throughput/IOPS:**- **Action:** If disk I/O utilization is also consistently high (e.g., near 100%), consider temporarily increasing your disk's provisioned IOPS and throughput.- **Why it helps:** Autovacuum is an I/O-intensive operation, involving a lot of reading and writing. Higher disk performance can significantly speed up the process.- - **Considerations:** Cloud providers may limit the number of disk modifications (e.g., up to four in a rolling 24-hour window). You can start a new modification immediately after the previous one finishes, provided you have not exceeded this rolling 24-hour quota.+ - **Considerations:** Cloud providers often have limitations, such as a cooldown period (e.g., 4 hours) between disk modification operations.## Monitoring progress and future preventiondiff --git a/apps/docs/content/troubleshooting/how-to-bypass-cooldown-period.mdx b/apps/docs/content/troubleshooting/how-to-bypass-cooldown-period.mdxindex 324673eaf78..53d114e7db5 100644--- a/apps/docs/content/troubleshooting/how-to-bypass-cooldown-period.mdx+++ b/apps/docs/content/troubleshooting/how-to-bypass-cooldown-period.mdx@@ -1,22 +1,20 @@----title = "How to bypass modification limits"+title = "How to bypass cooldown period"topics = [ "platform" ]-keywords = [ "modification limits", "disk resize" ]+keywords = [ "cooldown", "disk resize" ]database_id = "6f6a34a6-ac3f-4fba-9c70-4f4b8c7aeda7"----This limit is not a Supabase limitation. It is rooted in how Amazon EBS (the underlying storage for our databases) manages volume modifications. AWS allows up to four modifications per volume within a rolling 24-hour window. While you can start a new modification immediately after a previous one completes, AWS enforces a quota that prevents a fifth modification within that 24-hour period to ensure data integrity and volume stability.+This cooldown isn't an arbitrary Supabase restriction — it's rooted in how Amazon EBS (the underlying storage for our databases) limits volume modifications to up to four times within a rolling 24-hour window. To keep this predictable, Supabase enforces a 4-hour cooldown after each manual disk modification (e.g. increasing size, changing type, or IOPS) before allowing another one on the same volume. This helps ensure data integrity and stability of the volume under load.-From the [**AWS docs**](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyVolume.html):+See the [**AWS docs**](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyVolume.html) for more on how Amazon EBS itself throttles volume modifications.-> After you initiate a volume modification, you must wait for that modification to reach the completed state before you can initiate another modification for the same volume. You can modify a volume up to four times within a rolling 24-hour period, as long as the volume is in the in-use or available state, and all previous modifications for that volume are completed. If you exceed this limit, you get an error message that indicates when you can perform your next modification.+There are a few options to work around the cooldown, depending on the state of your database:-There are a few options to work around this limit if you have already used your four modifications and need to make further adjustments:--1. **Restore to a new project**: This spins up a new instance with a new disk, bypassing the 24-hour quota entirely. It’s a great option if you're okay with a new project and project refactoring. [**Docs: restoring to a new project**](/docs/guides/platform/backups#restore-to-a-new-project).-2. **pg_upgrade**: Our [**pg_upgrade**](/docs/guides/platform/upgrading) implementation migrates your data to a new disk, which resets the modification count. The main requirement here is that the database must be operational - pg_upgrade can't run if your database is in a degraded or inaccessible state.+1. **Restore to a new project**: This spins up a new instance with a new disk, bypassing the cooldown entirely. It’s a great option if you're okay with a new project and project refactoring. [**Docs: restoring to a new project**](/docs/guides/platform/backups#restore-to-a-new-project).+2. **pg_upgrade**: Our [**pg_upgrade**](/docs/guides/platform/upgrading) implementation migrates your data to a new disk, which skips the cooldown. The main requirement here is that the database must be operational - pg_upgrade can't run if your database is in a degraded or inaccessible state.3. **Pause and Restore**: This also migrates to a new disk but is only available for projects on the Free plan. If you're not on the Free plan, you'd need to [**transfer your project to an organization on the Free plan**](/docs/guides/platform/project-transfer) first.-If the database is down or locked in a bad state (e.g., corrupted or stuck during resize), and you have hit the modification limit, the only path forward is to wait until the rolling 24-hour window allows for another modification.+If the database is down or locked in a bad state (e.g., corrupted or stuck during resize), the only path forward is to wait until the cooldown expires and the disk resize job completes in the queue.More on this in our doc here: [**https://supabase.com/docs/guides/platform/database-size#disk-size**](/docs/guides/platform/database-size#disk-size).diff --git a/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.sections.tsx b/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.sections.tsxindex 1dcdceda2f1..35e020757b1 100644--- a/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.sections.tsx+++ b/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.sections.tsx@@ -297,7 +297,7 @@ export function AdvancedSection({isDiskTooSmallForCustomIops && !disableIopsThroughputConfig && !disableDiskInputs}title="Increase disk size to adjust IOPS or throughput"- description={`This disk is too small to update IOPS or throughput, since gp3 volumes are capped at 500 IOPS per GB with a 3,000 IOPS minimum. Resizing to ${suggestedDiskSizeForCustomIops} GB unlocks custom IOPS and throughput, and leaves headroom for further adjustments (disk config changes are limited to 4 within a rolling 24-hour window).`}+ description={`This disk is too small to update IOPS or throughput, since gp3 volumes are capped at 500 IOPS per GB with a 3,000 IOPS minimum. Resizing to ${suggestedDiskSizeForCustomIops} GB unlocks custom IOPS and throughput, and leaves headroom for further adjustments (disk config changes are locked for 4 hours after each resize).`}actions={!disableDiskSizeInput ? (<Buttondiff --git a/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.tsx b/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.tsxindex 04b0064ee49..f45cc9c68a4 100644--- a/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.tsx+++ b/apps/studio/components/interfaces/DiskManagement/DiskManagementForm.tsx@@ -221,7 +221,7 @@ export function DiskManagementForm({DISK_LIMITS[DiskType.GP3].minIops)// Suggested target when prompting a resize, sits above the floor so users- // aren't pinned at the minimum between disk-config modifications.+ // aren't pinned at the minimum during the 4-hour disk-config cooldown.const suggestedDiskSizeForCustomIops = PLAN_DETAILS.pro.includedDiskGB.gp3const isDiskTooSmallForCustomIops =watchedStorageType === 'gp3' && watchedTotalSize < minDiskSizeForCustomIopsdiff --git a/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.hooks.ts b/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.hooks.tsindex 56db829918d..c38d10ded94 100644--- a/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.hooks.ts+++ b/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.hooks.ts@@ -180,7 +180,7 @@ export function useDiskManagementReviewChanges(Number(iopsPrice.newPrice) !== Number(iopsPrice.oldPrice) ||Number(throughputPrice.newPrice) !== Number(throughputPrice.oldPrice)- // Show cooldown warning whenever any disk attribute that counts toward the 24-hour modification limit changes+ // Show cooldown warning whenever any disk attribute that enforces the 4-hour lock changesconst anyDiskAttributeChange = hasIOPSChanges || hasStorageTypeChanges || hasTotalSizeChanges// Show extended downtime warning when resizing to/from a size below largediff --git a/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.tsx b/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.tsxindex 1034f3e7100..3e140536b50 100644--- a/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.tsx+++ b/apps/studio/components/interfaces/DiskManagement/DiskManagementReviewAndSubmitDialog/DiskManagementReviewAndSubmitDialog.tsx@@ -188,7 +188,7 @@ export const DiskManagementReviewAndSubmitDialog = ({label="IOPS"description={anyDiskAttributeChange && !hasTotalSizeChanges && !hasStorageTypeChanges- ? 'Disk attributes, including IOPS and disk size, may only be modified 4 times within a rolling 24-hour window. A new modification can be started as soon as the previous one completes.'+ ? 'Disk attributes, including IOPS and disk size, will be locked for 4 hours after this change.': undefined}>@@ -217,7 +217,7 @@ export const DiskManagementReviewAndSubmitDialog = ({{(hasTotalSizeChanges || hasStorageTypeChanges) && (<BreakdownRowlabel="Disk size"- description="You can modify disk attributes up to 4 times within a rolling 24-hour window."+ description="For 4 hours after changes you will not be able to modify disk attributes."><div className="flex flex-col items-end gap-0.5"><ValueChangediff --git a/apps/studio/components/interfaces/DiskManagement/ui/DiskCountdownRadial.tsx b/apps/studio/components/interfaces/DiskManagement/ui/DiskCountdownRadial.tsxindex e67a3f179da..053b28352e9 100644--- a/apps/studio/components/interfaces/DiskManagement/ui/DiskCountdownRadial.tsx+++ b/apps/studio/components/interfaces/DiskManagement/ui/DiskCountdownRadial.tsx@@ -51,10 +51,12 @@ export function DiskCountdownRadial() {<CountdownTimerRadial progress={progressPercentage} /><div className="flex flex-col gap-2"><div>- <p className="text-foreground text-sm p-0">Disk modification limit reached</p>+ <p className="text-foreground text-sm p-0">+ 4-hour cooldown period is in progress+ </p><p className="text-foreground-lighter text-sm p-0">- You can modify disk attributes up to 4 times within a rolling 24-hour window.- You'll be able to make changes again once the window allows it.+ You can't modify your disk configuration again until the 4-hour cool down period+ ends.</p></div><CountdownTimerSpan seconds={remainingTime} />diff --git a/apps/studio/components/interfaces/Settings/Database/DiskSizeConfigurationModal.tsx b/apps/studio/components/interfaces/Settings/Database/DiskSizeConfigurationModal.tsxindex 43a9f4bb01f..01ef7d240f4 100644--- a/apps/studio/components/interfaces/Settings/Database/DiskSizeConfigurationModal.tsx+++ b/apps/studio/components/interfaces/Settings/Database/DiskSizeConfigurationModal.tsx@@ -180,16 +180,16 @@ const DiskSizeConfigurationModal = ({<DialogSection className="w-full space-y-4"><Alert variant={isAbleToResizeDatabase ? 'default' : 'warning'}><Info size={16} />- <AlertTitle>- Disk modifications are limited to 4 per rolling 24-hour window- </AlertTitle>+ <AlertTitle>This operation is only possible every 4 hours</AlertTitle><AlertDescription><div className="mb-4">{isAbleToResizeDatabase- ? `You can modify disk attributes up to 4 times within a rolling 24-hour window. A new modification can be started as soon as the previous one completes.`+ ? `Upon updating your disk size, the next disk size update will only be available from ${dayjs().format(+ 'DD MMM YYYY, HH:mm (ZZ)'+ )}`: `Your database was last resized at ${dayjs(lastDatabaseResizeAt).format('DD MMM YYYY, HH:mm (ZZ)'- )}. You've reached the disk modification limit for now — you can resize again in approximately ${formattedTimeTillNextAvailableResize}.`}+ )}. You can resize your database again in approximately ${formattedTimeTillNextAvailableResize}`}</div><Button asChild iconRight={<ExternalLink size={14} />}><Link href={`${DOCS_URL}/guides/platform/database-size#disk-management`}>