Render Platform Maintenance

Learn about periodic upgrades to Render's underlying infrastructure.

Render routinely performs infrastructure maintenance to improve platform performance, reliability, and security.

In most cases, maintenance is completely transparent, with no interruption to your services.

Service-affecting maintenance

Maintenance never changes a service’s configuration details or instance type.

Certain types of maintenance (such as OS upgrades) do require brief downtime, specifically for services that provide persistent storage:

To ensure the integrity of your data, Render spins down these service instances completely before spinning up their replacements. This process usually takes a few minutes. For Render Postgres databases with high availability, this is reduced to less than one minute.

+ What about other services?

Services without attached storage (“stateless” services) remain available during maintenance windows, because they support zero-downtime deploys. Render can spin up new instances for these services before deprovisioning the old ones, ensuring there’s always a routing destination for incoming traffic:

Original instance
(v1)
New instance
(v2)
Render
load balancer

For services that perform long-running tasks (such as background workers), make sure these services define logic to handle a graceful shutdown in the event of receiving a SIGTERM signal. Render sends this signal when spinning down an instance as part of maintenance (and as part of any zero-downtime deploy).

Resolving maintenance deploy failures

For assistance resolving a maintenance deploy failure:

As part of service-affecting maintenance, Render deploys your services to new instances before spinning down the old ones. In certain cases, this deploy might fail. This most commonly occurs if your service’s most recent deploys were failing before maintenance began, indicating an issue with your service’s current build and deploy configuration.

In the event of a deploy failure, Render keeps your old instance running (until a specified deadline) and continues routing traffic to it:

Original instance
(v1)
New instance
(v2)
Render
load balancer

Render immediately notifies you by email if a maintenance deploy fails. This email includes a deadline for resolving the issue, after which Render will bring down the old instance. If you do not resolve the issue before the deadline, your service will be taken offline.

Rescheduling maintenance

Free services do not support rescheduling maintenance.

Render might perform maintenance on a free service at any time, without advance notice.

If any of your paid services will experience downtime as part of a maintenance window, Render always provides advance notice via email and in the Render Dashboard. Service-affecting maintenance windows usually occur no more than once every three months.

Whenever possible, Render provides the ability to reschedule a paid service’s maintenance window to a more convenient time (usually within a few days of the original scheduled date). You can reschedule in the Render Dashboard or via the Render API.

Triggering maintenance

Both the Render Dashboard and API support immediately triggering a service’s scheduled maintenance.

The following actions also trigger maintenance immediately, because they already involve replacing a service’s current instance with a new one:

  • Redeploying a service
  • Restarting a Render Postgres database
  • Suspending and resuming a Render Postgres database
  • Changing the instance type for any service, Render Postgres database, or Render Key Value instance