# Warden ZFS Troubleshooting

Use this file when Bastille ZFS layout or jail storage looks wrong.

## Quick checks

### Pool state

```sh
zpool status zroot
```

Expected:
- pool exists
- health is `ONLINE`

### Dataset layout

```sh
zfs list | grep clawdie-runtime
```

Expected:
- `zroot/clawdie-runtime`
- `zroot/clawdie-runtime/jails`
- `zroot/clawdie-runtime/releases`
- `zroot/clawdie-runtime/templates`

### Bastille config

Check:

- `bastille_zfs_enable="YES"`
- `bastille_zfs_zpool="zroot"`
- `bastille_zfs_prefix="clawdie-runtime"`

## Common failure signatures

### Bastille says ZFS is enabled in rc.conf but not bastille.conf

Likely cause:
- missing `bastille_zfs_enable="YES"`

### Bastille creates wrong dataset namespace

Likely cause:
- stale or wrong `bastille_zfs_prefix`

### Snapshot path not found

Likely causes:
- jail dataset path is not under `clawdie-runtime`
- jail was created under an old Bastille/ZFS layout

