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

# Basins

> Create, list, inspect, reconfigure, and delete basins with the S2 CLI.

### List basins

```bash theme={null}
s2 ls
```

```
my-basin        active
another-basin   active
```

Use `--prefix` to filter and `--limit` to paginate:

```bash theme={null}
s2 ls --prefix "my-" --limit 10
```

### Create a basin

```bash theme={null}
s2 create-basin my-basin
```

Create in a specific [location](/concepts/basins#location):

```bash theme={null}
s2 create-basin my-basin --location aws:us-east-1
```

<Tip>
  Basin names must be globally unique, 8–48 characters, lowercase letters/numbers/hyphens.
</Tip>

Options for default stream configuration:

```bash theme={null}
s2 create-basin my-basin \
  --stream-cipher aegis-256 \
  --storage-class express \
  --retention-policy 7d \
  --create-stream-on-append \
  --create-stream-on-read
```

### Get basin config

```bash theme={null}
s2 get-basin-config my-basin
```

### Reconfigure a basin

```bash theme={null}
s2 reconfigure-basin my-basin \
  --stream-cipher aes-256-gcm \
  --create-stream-on-append true \
  --retention-policy 30d
```

<Note>
  `--stream-cipher`: Encryption algorithm to apply to newly created streams in this basin.

  Existing streams keep the `cipher` they were created with.
</Note>

### Delete a basin

```bash theme={null}
s2 delete-basin my-basin
```