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

Outdated Documentation

You're viewing documentation for version v1.0.5. This version may contain outdated information.

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