[Important Security Notice] Fake Qfinder Pro Websites Detected. Learn more >

How do I set up or change the storage path in HDP for SaaS 2.0 and later?


Last modified date: 2025-11-28

Applicable Products

HDP for SaaS
Starting from version 2.4, the product previously known as Boxafe has been renamed to HDP for SaaS.


The HDP for SaaS Storage Path

The HDP for SaaS storage path is the folder where HDP for SaaS 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 HDP for SaaS versions 2.0 and later, the storage path can be changed to be any folder on your NAS. By changing the storage path, HDP for SaaS 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 HDP for SaaS 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 HDP for SaaS storage path to the default HDP for SaaS storage path.

Tip

This option appears only when starting HDP for SaaS 2.0 for the first time

Create new storage pathSets the HDP for SaaS 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 HDP for SaaS after the new storage path is created, and must be added again.
Use a pre-existing HDP for SaaS storage pathSets the HDP for SaaS storage path to a storage location that had been used as a HDP for SaaS storage path previously.
Tip
  • Existing HDP for SaaS storage data will not be deleted after relinking to a different HDP for SaaS 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 HDP for SaaS storage path can be changed at most 5 times. Attempting to change the storage path more than 5 times will result in all HDP for SaaS licenses associated with your NAS user account to be blacklisted. If your HDP for SaaS licenses are blacklisted, please contact QNAP Customer Service.

Scenarios

The following user scenarios involve configuring the HDP for SaaS storage path:

Configuring the HDP for SaaS storage path for the first time (new HDP for SaaS 2.0 and later users)
  1. Open HDP for SaaS.
    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 HDP for SaaS storage"  below.
    3. Use a pre-existing HDP for SaaS storage path
      For details, see the section "Migrating an Existing HDP for SaaS 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 HDP for SaaS storage path was selected then specify the existing HDP for SaaS 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 HDP for SaaS storage path was selected, then select I have moved or copied existing HDP for SaaS 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 HDP for SaaS 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 HDP for SaaS 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 HDP for SaaS storage path is set to the new folder. Backup jobs can now be run as normal to backup your domain data.
Moving an existing HDP for SaaS storage to another folder

An existing HDP for SaaS storage can be moved to another folder by performing the following steps:

  1. Log into your NAS as an administrator.
  2. If HDP for SaaS is running, stop HDP for SaaS.
    1. Open App Center.
    2. Locate HDP for SaaS.
    3. Click .
    4. Click Stop.
    5. Stopping HDP for SaaS may take several minutes. When HDP for SaaS is stopped, the HDP for SaaS 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
      HDP for SaaS does not support folder names with special characters or spaces.
    5. Click OK.
  4. Move HDP for SaaS 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 HDP for SaaS.
    1. Open App Center.
    2. Locate HDP for SaaS.
    3. Click Start.
  6. Open HDP for SaaS.
  7. Go to Settings > Preferences > Storage Settings.
  8. Next to Storage path, click .
  9. Select Use a pre-existing HDP for SaaS 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 HDP for SaaS 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.
    HDP for SaaS will now use the new storage path.

Further Reading

How do I access my QNAP NAS using SSH?

Was this article helpful?

60% 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
      back to top