> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro deployment hibernate

> Hibernate a Deployment.

> [!NOTE]
>
> This command works differently depending on which Astronomer product you use. Select your product tab to see the details.

**Astro**

[Hibernate an Astro development Deployment](https://astronomer.io/docs/astro/deployment-resources.md#hibernate-a-development-deployment) for a set amount of time. Overrides any existing hibernation schedule and sets the Deployment to hibernate for a specific duration or until a specific date.

> [!NOTE]
>
> To complete this action, you need [Workspace Operator](https://astronomer.io/docs/astro/user-permissions.md#workspace-roles) permissions or a custom Deployment role that includes `deployment.hibernation.update`. Every option on this command sets or removes a hibernation override, so they all require this permission. Creating and editing hibernation schedules requires `deployment.update` instead. See [Custom role permissions reference](https://astronomer.io/docs/astro/deployment-role-reference.md#deployment-hibernation).

## Usage

```sh wrap theme={null}
astro deployment hibernate [one of --until/ --for/ --remove-override]
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `-n`,`--deployment-name` | The name of the development Deployment to hibernate. | Any valid Deployment name |
| `-u, --until` | Specify the hibernation period using an end date and time. | Any future date in the format `YYYY-MM-DDT00:00:00Z` |
| `-d, --for` | Specify the hibernation period using a duration. | Any amount of time in the format `XhYm` |
| `-r, --remove-override` | Remove any existing override and resume regular hibernation schedule. | None |
| `-f, --force` | The CLI will not prompt to confirm before hibernating the Deployment. | None |

**APC**

Hibernate an Astro Private Cloud Deployment. Overrides any existing hibernation schedule and sets the Deployment to hibernate until you remove the override, for a specific duration, or until a specific time.

> [!NOTE]
>
> This command requires Astro Private Cloud 2.2 or later.

## Usage

```sh wrap theme={null}
astro deployment hibernate <deployment-id>
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `-u`, `--until` | Specify the hibernation period using an end date and time. | Any future date in the format `YYYY-MM-DDT00:00:00Z` |
| `-d`, `--for` | Specify the hibernation period using a duration. | Any amount of time in the format `XhYm` |
| `-r`, `--remove-override` | Remove any existing override and resume the regular hibernation schedule. | None |
| `-f`, `--force` | The CLI will not prompt to confirm before hibernating the Deployment. | None |
| `--workspace-id` | The Workspace that contains the Deployment. The default is the Workspace in your current context. | Any valid Workspace ID |

## Examples

```sh wrap theme={null}
# Hibernate until you remove the override
astro deployment hibernate <deployment-id>

# Hibernate for a duration
astro deployment hibernate <deployment-id> --for 2h30m

# Hibernate until a specific time
astro deployment hibernate <deployment-id> --until 2026-06-01T12:00:00Z

# Remove any existing override and resume the regular hibernation schedule
astro deployment hibernate <deployment-id> --remove-override
```

## Related commands

* [`astro deployment wake-up`](https://astronomer.io/docs/cli/v1.47/astro-deployment-wake-up)