Cannot attach an Encrypted Repository

Product version: 11.0.4

Last modified: 07 November 2025

Problem

After migrating an encrypted forever incremental repository from a host running Ubuntu 20.04 to a new host running Ubuntu 24.04, it is not possible to attach the repository in NAKIVO Backup & Replication.

Background

The encrypted repository mount is successful at the OS level, but the NAKIVO Transporter could not access it.

The problem occurs when the raw folder within the encrypted repository doesn’t have the required executable (traverse) permission. Without this permission, the Transporter process cannot read or traverse the directory, causing the repository attach operation to hang indefinitely.

Solution

To restore access to the encrypted repository, do the following:

1. Adjust folder permissions for the raw directory:

   sudo chmod 770 /path/to/repository/raw

   This grants read, write, and execute permissions to the owner and group, allowing the Transporter process to traverse the folder.

2. Restart the NAKIVO Transporter service:

   sudo systemctl restart nkv-bhsvc

3. Reattach the repository through the NAKIVO web interface:

   1. Go to Settings > Repositories tab.

   2. Hover over a Backup Repository and click •••.

   3. Click Attach.

   4. Ensure the repository is now attached and initialized successfully.

4. (Optional) Perform Self-healing on the repository to verify data consistency.