Creating a Configuration File

Follow the steps below to ensure that you are creating a configuration file that is correctly defined.

In this process, you will add an account to Drive, and create a configuration file based on that account. But next, so that you can verify that the configuration file is working, you will delete the account you had created. Then, when you load the configuration file, you will see the account information correctly represented in Drive.

  1. Select Preferences > Accounts to add the account to Drive.
    For instructions, see Adding a Drive Account for Shares for a Shares server, or Adding a Drive Account for Faspex for a Faspex server.
    When you add the account, also configure any other aspects of it that you want to control, such as:
    • the sync directory or download destination directory
    • the time interval for checking for transfers
    • a passphrase for encrypted packages
  2. Once you have added the account, close Drive: Right-click its icon in the system tray, and select Quit.
  3. Create a configuration file by typing the following in a command prompt window:
    "C:\Users\username\AppData\Local\Programs\Aspera\Aspera Drive\bin\asperadrive.exe" -w configurationFile
  4. Open the configuration file and edit it as necessary.
    For an example, see Sample Configuration File.
  5. Start Drive and go to Preferences > Accounts.
  6. Delete the account that you created in Step 1.
    Note: You are deleting the account so that, in the next steps, you can verify that the configuration file is working.
  7. Quit Drive.
    Note: You must quit Drive before using the configuration file.
  8. Load the account from the configuration file by running the following in a command prompt window:
    "C:\Users\username\AppData\Local\Programs\Aspera\Aspera Drive\bin\asperadrive.exe" -f configurationFile
  9. Restart Drive, and verify that the account has been loaded correctly by going to Preferences > Accounts.
You can now use the configuration file to load the account into any Drive installation.
Note: The account settings that you specify in the configuration file are loaded only for accounts that do not already exist in Drive. If an account already exists in Drive, or if the configuration file contains settings for an account that already exists, that account's settings are not changed when the configuration file is loaded.

This disparity is not usually an issue because in most cases, the configuration file is only loaded when Drive is first installed. However, if you use a configuration file with an existing Drive installation, note the distinction.