Skip to main content
This guide takes the shortest path to a durable file: install the CLI, mount a volume, write a file, and verify that it survives an unmount.

Before you begin

You need an Amulet account and a Linux environment with FUSE. See Mount on Linux for platform and mount requirements. Keep two terminals open: one for the mount process and one for file operations.
1

Install the CLI

If the installer prints a PATH command, run it before continuing.
2

Export your API key

Create a key in the API Keys tab. Copy the secret when it appears, then export it:
3

Mount the volume

Run this in the first terminal and keep it running:
The command creates the volume and local mount directory if they do not exist.
4

Write a file

In another terminal:
5

Unmount and remount

Start the same mount command again in the first terminal:
Then confirm from the second terminal that the file persisted:
When you are finished, unmount once more:

Manage volumes

List, remount, and delete volumes.

Work with branches

Give a job an isolated writable filesystem.

Save a snapshot

Preserve and mount an immutable version.