> V1.1.0 > Guides > Create kloset repository
Version v1.1.0

Beta Version

You're viewing documentation for version v1.1.0. Beta versions are subject to changes and may not represent the final stable release. Do not use in production environments.

Creating a Kloset Store

Last reviewed: 2026-01-29 / Plakar v1.1.0

Overview

A Kloset store is Plakar’s immutable storage backend for backup data. This guide covers filesystem-based store creation. You can learn more in the Kloset deep dive article

Create Store with Path

plakar at /var/backups create

Plakar prompts for an encryption passphrase. To avoid the prompt, set:

export PLAKAR_PASSPHRASE="my-secret-passphrase"
plakar at /var/backups create

Create Store with Alias

Configure store once, reference by alias in all commands:

plakar store add mybackups /var/backups passphrase=xxx

Use the configured store:

plakar at @mybackups create
plakar at @mybackups ls

Update store configuration

plakar store set mybackups passphrase=yyy
Passphrase Changes

Updating the passphrase only affects the configuration. Existing data created with the old passphrase requires the original passphrase to access.

Default Store Location

Without specifying a path, plakar create uses ~/.plakar:

plakar create

When to Use Aliases

Use aliases for:

  • Stores requiring credentials (S3, cloud storage)
  • Multiple stores with different configurations
  • Avoiding repetitive path specifications

Found a bug or mistake in the documentation? Create an issue on GitHub