How do I set up or change the storage path in Boxafe 2.0 and later?


Last modified date: 2025-06-05

Applicable Products

Boxafe 2.0 or later


The Boxafe Storage Path

The Boxafe storage path is the folder where Boxafe backup data is stored. The storage path is set by default to a specific folder on your NAS and this folder cannot be accessed by other QNAP apps, such as File Station. In Boxafe version 1.x, the storage path cannot be changed, but in Boxafe versions 2.0 and later, the storage path can be changed to be any folder on your NAS. By changing the storage path, Boxafe backup data can be made accessible to other QNAP apps such as File Station, Storage & Snapshots, and Hybrid Backup Sync.

This tutorial explains the different options for the Boxafe storage path and provides solutions to several common user scenarios involving the storage path.


Storage Path Options

Storage OptionDescription
Keep current storage path

Sets the Boxafe storage path to the default Boxafe storage path.

Tip

This option appears only when starting Boxafe 2.0 for the first time

Create new storage pathSets the Boxafe storage path to a new location. The new location must be an empty folder.
Important
  • If the previous storage path was the Boxafe 1.5 storage path, then all data at this previous path will be deleted.
  • All domains and domain users will be removed from Boxafe after the new storage path is created, and must be added again.
Use a pre-existing Boxafe storage pathSets the Boxafe storage path to a storage location that had been used as a Boxafe storage path previously.
Tip
  • Existing Boxafe storage data will not be deleted after relinking to a different Boxafe storage path.
  • The storage path can be later changed back to the original storage path by relinking back to the original storage path.
Warning
The Boxafe storage path can be changed at most 5 times. Attempting to change the storage path more than 5 times will result in all Boxafe licenses associated with your NAS user account to be blacklisted. If your Boxafe licenses are blacklisted, please contact QNAP Customer Service.

Scenarios

The following user scenarios involve configuring the Boxafe storage path:

Configuring the Boxafe storage path for the first time (new Boxafe 2.0 and later users)
  1. Open Boxafe.
    The Storage Path Configuration window appears.
  2. Select one of the following:
    1. Keep current storage path
    2. Create new storage path
      For details, see the section "Creating a new Boxafe storage"  below.
    3. Use a pre-existing Boxafe storage path
      For details, see the section "Migrating an Existing Boxafe Storage to Another Location" below.
    For details on these storage options see the "Storage Path Options" table above.
  3. If Create new storage path was selected then specify the new folder, or if Use a pre-existing Boxafe storage path was selected then specify the existing Boxafe storage location:
    1. Next to New storage path, click Select Path.
      The Select NAS Folder window appears.
    2. Select the desired folder.
    3. Click Select Path.
    4. Click Apply.
  4. If Use a pre-existing Boxafe storage path was selected, then select I have moved or copied existing Boxafe data to the new storage location.
  5. Click Appy.
    The Confirmation Storage Path Change window appears.
  6. Enter your NAS account password.
  7. Click Confirm.
Creating a new Boxafe storage
  1. Log into your NAS as an administrator.
  2. Create a new folder.
    1. Open File Station.
    2. Navigate to the desired parent folder.
    3. Create a new folder by clicking .
      The Create folder window appears.
    4. Under Folder name, specify the folder name.
    5. Click OK.
  3. Open Boxafe 2.0.
  4. Go to Settings > Preferences > Storage Settings.
  5. Next to Storage path, click .
    The Storage Path Configuration window appears.
  6. Select Create new storage path.
  7. Next to New storage path, click Select Path.
    The Select NAS Folder window appears.
  8. Select the newly created folder from the above steps.
  9. Click Select Path.
  10. Click Apply.
    The Confirmation Storage Path Change window appears.
  11. Enter your NAS account password.
  12. Click Confirm.
    The Boxafe storage path is set to the new folder. Backup jobs can now be run as normal to backup your domain data.
Moving an existing Boxafe storage to another folder

An existing Boxafe storage can be moved to another folder by performing the following steps:

  1. Log into your NAS as an administrator.
  2. If Boxafe is running, stop Boxafe.
    1. Open App Center.
    2. Locate Boxafe.
    3. Click .
    4. Click Stop.
    5. Stopping Boxafe may take several minutes. When Boxafe is stopped, the Boxafe app button will display "Start".
  3. Create the destination folder.
    1. Open File Station.
    2. Navigate to the desired parent folder.
    3. Create a new folder by clicking .
      The Create folder window appears.
    4. Under Folder name, specify the folder name.
      Important
      Boxafe does not support folder names with special characters or spaces.
    5. Click OK.
  4. Move Boxafe storage data from the current source folder to the new destination folder.
    1. Access your NAS via SSH by following the steps in How do I access my QNAP NAS using SSH?
    2. In the SSH terminal, enter the following commands:
      mv -f <source_folder> <destination_folder>/

      VariableDescriptionExample
      <source_folder>The source storage path/share/CACHEDEV1_DATA/.qpkg/boxafe/storage
      <destination_folder>The destination storage path/share/Public/BoxafeStorage

      A subdirectory "Storage" under <destination_folder> will be created and all files in the source folder are migrated to <destination_folder>/Storage.

  5. Start Boxafe.
    1. Open App Center.
    2. Locate Boxafe.
    3. Click Start.
  6. Open Boxafe.
  7. Go to Settings > Preferences > Storage Settings.
  8. Next to Storage path, click .
  9. Select Use a pre-existing Boxafe storage path.
  10. Next to New storage path, click Select Path.
    The Select NAS Folder window appears.
  11. Select the destination storage folder.
  12. Click Select Path.
  13. Select I have moved or copied existing Boxafe data to the new storage location.
  14. Click Apply.
    The Confirmation Storage Path Change window appears.
  15. Enter your NAS account password.
  16. Click Confirm.
    It may take several minutes to apply the new storage path. After the new storage path is successfully applied, a success window appears.
  17. Click OK
  18. Refresh the browser page.
    Boxafe will now use the new storage path.

Further Reading

How do I access my QNAP NAS using SSH?

Was this article helpful?

75% of people think it helps.
Thank you for your feedback.

Please tell us how this article can be improved:

If you want to provide additional feedback, please include it below.

Choose specification

      Show more Less

      Choose Your Country or Region

      open menu
      back to top