Skip to main content
A branch starts with the files from a volume or another branch, then keeps its own changes. This guide uses the demo volume from the Quickstart.
1

Create and mount a branch

Mount a missing branch to create it from the volume’s current state:
Keep the command running.
2

Write isolated changes

From another terminal:
The file belongs to demo@experiment; it is not written to the volume head.
3

List branches

The output should include experiment.
4

Unmount the branch

​
Fork from another branch

Create review from the current state of experiment:
The source option is used only when the target branch is first created. If the target already exists with different source information, Amulet returns an error instead of silently changing its history.

​
Delete a branch

Unmount it first, then run:
Deleting a branch does not delete the volume or sibling branches. To start from an immutable version instead, follow Restore from a snapshot.