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

# Manage a volume

> Create, list, mount, remount, and delete durable storage.

Use a volume for the durable default state of a filesystem. Mounting a missing
volume creates it automatically; `amulet create` is useful when you want to
provision one without mounting it.

<Steps>
  <Step title="Create a volume">
    ```bash theme={null}
    amulet create project-data
    ```
  </Step>

  <Step title="List volumes">
    ```bash theme={null}
    amulet list
    ```

    The output should include `project-data`.
  </Step>

  <Step title="Mount and write data">
    Keep the mount running in one terminal:

    ```bash theme={null}
    amulet mount project-data ./project-data
    ```

    Write from another terminal:

    ```bash theme={null}
    mkdir -p ./project-data/results
    echo "complete" > ./project-data/results/status.txt
    ```
  </Step>

  <Step title="Unmount and reconnect">
    ```bash theme={null}
    amulet unmount ./project-data
    amulet mount project-data ./project-data
    ```

    Verify the file from another terminal:

    ```bash theme={null}
    cat ./project-data/results/status.txt
    ```
  </Step>
</Steps>

## Mount without a path

If you omit the local path, Amulet mounts at `./<volume>`:

```bash theme={null}
amulet mount project-data
```

## Delete a volume

Unmount the volume first, then delete it:

```bash theme={null}
amulet delete project-data --force
```

Deleting a volume also deletes its branches and snapshots. The CLI asks for
confirmation; add `--yes` only in an intentional non-interactive workflow.

<Warning>
  Volume deletion cannot be undone. Verify the volume name and preserve any
  required files before continuing.
</Warning>
