Configuring Autosuspend for Neon computes

Neon's Autosuspend feature controls when a Neon compute instance transitions to an Idle state (scales to zero) due to inactivity. This guide demonstrates how to configure the autosuspend setting in your Neon project.

Neon Pro Plan users can configure the autosuspend setting for a new project, for an existing project, or for an individual compute endpoint. Configuring the autosuspend setting for a new or existing project sets the project's default autosuspend setting, which is used from that point forward when creating new compute endpoints.

Configure the autosuspend setting for a new project

Configuring the autosuspend setting for a new project sets the project's default, which is applied to all compute endpoints created from that point forward. You can adjust this autosuspend default at any time, or configure the setting for individual compute endpoints later, as necessary.

To configure the autosuspend default setting when you first create your project:

1. Navigate to the Neon Console.

2. If you are creating your very first project, click Create a project. Otherwise, click New Project.

3. Specify a name, a Postgres version, and a region.

4. Under Compute size, select Suspend compute after a period of inactivity and specify your delay period (5 minutes or a custom period). The maximum setting is 7 days. Deselecting Suspend compute after a period of inactivity means the compute is always active.

   note

   You can configure default Compute size settings at the same time.

5. Click Save.

6. Click Create Project. Your initial compute endpoint is created with the specified setting.

Configure the autosuspend setting for an existing project

Configuring the autosuspend setting for an existing project sets the project's default, which is applied to all compute endpoints created from that point forward. Existing compute endpoints are unaffected. You can adjust the autosuspend default or configure the setting for individual compute endpoints later, as necessary.

To configure the autosuspend default for an existing project:

1. Select a project in the Neon console.

2. On the Neon Dashboard, select Settings.

3. Select Compute and click Change.

4. Select Suspend compute after a period of inactivity and specify your delay period (5 minutes or a custom period). The maximum setting is 7 days. Deselecting Suspend compute after a period of inactivity means the compute is always active.

   note

   You can configure default Compute size settings at the same time.

5. Click Save.

Configure autosuspend for a compute endpoint

To configure the autosuspend setting for an individual compute endpoint:

1. In the Neon Console, select Branches.

2. Select a branch.

3. Click the menu in the Computes table, and select Edit.

4. Under Compute size, select Suspend compute after a period of inactivity and specify your delay period (5 minutes or a custom period). The maximum setting is 7 days. Deselecting Suspend compute after a period of inactivity means the compute is always active.

   note

   You can configure Compute size settings for your compute endpoint at the same time.

5. Click Save.

Monitor auto-suspension

You can monitor auto-suspension on the Branches page in the Neon Console. A compute reports either an Active or Idle status.

You can also view compute state transitions in the Branches widget on the Neon Dashboard.

User actions that activate an idle compute include connecting from a client such as psql, running a query on your database from the Neon SQL Editor, or accessing the compute via the Neon API.

You can try any of these methods and watch the status of your compute as it transitions from an Idle to an Active state.