Configure repository

Local filesystem

To create a repository in a local directory, create an INI file (name it how you want) with the following configuration:

[Repository]
URL = /path/to/repository

Once this is done, use rekkord init to create the repository.

S3 storage

To create a repository stored on an S3-compatible server, create an INI file (name it how you want) with the following configuration:

[Repository]
URL = https://<bucket>.s3.<region>.amazonaws.com/prefix/to/repository

[S3]
KeyID = <AWS access key ID>
SecretKey = <AWS secret key>

You can omit the SecretKey value, in which case a prompt will ask you the access key.

Once this is done, use rekkord init to create the repository.

SFTP server

To create a repository stored on an SFTP host, create an INI file (name it how you want) with the following configuration:

[Repository]
URL = ssh://<user>@<host>/path/to/repository

[SFTP]
Password = <SSH password>
KeyFile = <SSH keyfile>

Use either a password or a key file. If you omit both, a prompt will ask you for a password.

Just like with ssh, you will need to validate the host fingerprint the first time you connect to it. However, you can instead directly provide the correct host fingerprint as the Fingerprint to avoid this, as shown in the example below:

[Repository]
URL = ssh://foo@example.com/backup

[SFTP]
KeyFile = /home/bar/.ssh/id_ed25519
Fingerprint = SHA256:Y9pmJfkaok8t0dFJrfi8/LLUNhOYwAZGHUNGsYAiJUM

Once this is done, use rekkord init to create the repository.

Initialize repository

Once you have configured your repository, through a configuration file or with environment variables, you can initialize it with the following command:

export REKKORD_CONFIG_FILE=/path/to/config.ini
rekkord init

# Alternative: rekkord init -C /path/to/config.ini

This command will initialize the repository with a random 256-bit master key.

After initialization, the master key is exported to a binary file, named master.key by default (in the current directory). You can change the export file with the --key_file <file> option.

Rekkord uses multiple encryption keys which are derived from this master key:

• The config key (ckey) is paired with an access key (akey) for repository identity (RID and CID)
• The data key (dkey) is paired with a write key (wkey) for data encryption (snapshot information, directory metadata, file content)
• The log key (lkey) is paired with a tag key (tkey), to manage snapshots and record snapshot information
• The user key (ukey) is paired with a verify key (vkey) to detect tampering with keyfiles

Rekkord repositories support multiple user accounts. By default, two users accounts are created:

• full: This user has the keys necessary for read-write access to stored data
• write: This user can only write new data but cannot read historical data, or list existing snapshot

You will need one or the other to use other rekkord commands. Please store these passwords securely.

You can skip the creation of these two default users with rekkord init --skip_users, in which case you will have to create at least one user yourself with the help of the master key.

Repository users

As stated before, by default Rekkord creates two users named full and write. These are enough for simple needs.

Use the following commands to manage repository users:

• rekkord add_user
• rekkord delete_user
• rekkord list_users

To create a new user, you must either use an existing user with the necessary keys (a user with write-only role cannot create a user with read-write role), or use the master key file created by rekkord init.

export REKKORD_CONFIG_FILE=/path/to/config.ini

# Use existing user to create new user
export REKKORD_USER=full
rekkord add_user joe -r ReadWrite

# Or use the master key file
rekkord add_user -K master.key john -r ReadWrite

Most Rekkord commands require you to specify the user, you can do this in one of two ways:

• Set the REKKORD_USER environment variable (e.g. export REKKORD_USER=joe)
• Set the User setting in the Repository section of the config file (see example below)

[Repository]
URL = ssh://foo@example.com/backup
User = joe
# Password = Set the password here to avoid password prompt on each command

[SFTP]
KeyFile = <SSH keyfile>
Fingerprint = SHA256:<fingerprint>