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

# devbox release

> Release an acquired Devbox so it can be reused.

Release the lease on a Devbox obtained with `devbox acquire`. Releasing makes the Devbox eligible for a later acquisition with the same tag. It does not expire the Devbox.

Identify the lease by Devbox name, lease ID, or both. When neither is supplied, the CLI prompts you to select one of your leased Devboxes.

## Usage

```bash theme={null}
devbox release [name] [flags]
```

## Examples

### Release by lease ID

```bash theme={null}
devbox release --lease_id=LEASE_xyz
```

### Release a named Devbox lease

```bash theme={null}
devbox release my-devbox --lease_id=LEASE_xyz
```

## Options

**--lease\_id** `string`

Release the lease ID printed by `devbox acquire`. The Devbox name is optional when this option is supplied.

**--show\_all** `boolean` (default: false)

Include Devboxes created by other users when selecting a leased Devbox.

## Related topics

> [card] [Acquire a reusable Devbox](https://namespace.so/docs/reference/devbox-cli/acquire.md)
>
> Obtain the lease that this command releases.

> [card] [Delete a Devbox](https://namespace.so/docs/reference/devbox-cli/delete.md)
>
> Expire a Devbox instead of returning it for reuse.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.