Choose your vault

The first thing Pellet asks for is a vault — the folder your notes live in. That’s all a vault is. Not a database, not an account, not a special file format. A folder.

Picking one

You can point Pellet at:

• A new empty folder. Cleanest start. Make one wherever you keep documents.
• A folder you already have notes in. Pellet reads any .md files it finds.
• An existing Obsidian vault. It opens as-is — see Moving in from Obsidian.

If you’d rather look around before committing, Pellet ships with a demo vault you can open instead.

Where to put it

Somewhere you already back up. Pellet doesn’t back anything up for you — that’s deliberate, because it means your notes work with whatever you already use: Time Machine, Dropbox, iCloud Drive, a git repository, an external disk.

One thing to avoid

Don’t put a vault inside a folder that another app actively rewrites — a Dropbox folder is fine, but a folder that a sync client is constantly reorganizing can confuse any app watching for file changes. If you want Pellet on more than one device, its own sync is the safer route.

What Pellet adds to the folder

One directory, .pellet/, holding your settings, saved filters and window layout. Everything else in the vault is yours — notes, tasks, images, PDFs, whatever you put there.

Delete .pellet/ and you lose preferences. You never lose notes.

Changing your mind

You can switch vaults at any time from Settings, or open a second vault in a new window. Nothing is locked to the first folder you picked.