Here, you'll learn how to run a one-time scan of your cloud storage or email attachments using the Actifile Cloud & NAS Agent.
To run a one-time scan of your cloud storage or email attachments, follow the steps below.
Note: The Actifile agent only scans email attachments, not the email body.
Step 1. Open your command line interface and navigate to the folder where the Actifile Cloud & NAS Agent is stored. The Actifile team provides this agent directly. If you haven’t received it yet, please contact our support.
Step 2. Download the configuration file for the app of your choice and ensure you have access to the files you wish to scan with at least Read permissions. This article explains how to generate the file.
Step 3. Let’s check what drives are available for scanning. Run the following command in your command line, replacing the placeholders with your values.
- YOUR_CONFIG_FOLDER_PATH > the full path to the folder containing the config file you generated during step 2.
Microsoft OneDrive or SharePoint:
./agent --onedrive --config YOUR_CONFIG_FOLDER_PATH\actifile_onedrive.conf
Microsoft Outlook:
./agent --outlook --config YOUR_CONFIG_FOLDER_PATH\actifile_outlook.conf
Google Drive:
./agent --google-drive --config YOUR_CONFIG_FOLDER_PATH\actifile_googledrive.conf
Gmail:
Skip this step.
Example:

This command will output all accessible drives in JSON format. Example:
[
{
"id": "b!2NKWrQObE0CEm8pbd-T8FvdlTYy5Vz5AqLy8-TFe-lYyT-TlqqDHS5Ee1W5bqqFl",
"name": "files_for_test_mem/Documents"
},
{
"id": "b!9UsK1m6_ykGS7UYhHwZtBavIsdPCc6NFte-ZH-fiScFJSxI1RlifTa0EddOgpq1z",
"name": "Drive2/Documents"
},
.....
{
"id": "b!z7Db_DCcEU-u9CKuRWo4n0w-tk-6KnZFtYY9FRPHIxy4vFWuL3hsQoaVHU0Kr9SZ",
"name": "Communication Site2/Documents"
}
]
Step 4. To start the scan, execute the following commands, replacing placeholders with your values.
- YOUR_CONFIG_FOLDER_PATH > the full path to the folder containing the config file you generated during step 2.
- YOUR_DRIVE_ID > your drive’s “id” value from the JSON output.
- YOUR_DEVICE_NAME > choose a meaningful name for your device (can be omitted).
- YOUR_CACHE_FOLDER_PATH > the path to the folder where the agent will store the cache (can be omitted).
Note: By default, the device name is set to the user’s email address. Use the –device-name parameter to override it to your value.
Microsoft OneDrive or SharePoint:
./agent --onedrive --config YOUR_CONFIG_FOLDER_PATH\actifile_onedrive.conf --drive-id='YOUR_DRIVE_ID' --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH
Microsoft Outlook:
./agent --outlook --config YOUR_CONFIG_FOLDER_PATH\actifile_outlook.conf --user-id=YOUR_USER_ID --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH
Google Drive:
./agent --google-drive --config YOUR_CONFIG_FOLDER_PATH\actifile_googledrive.conf --drive-id='YOUR_DRIVE_ID' --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH
Gmail:
./agent --gmail --config YOUR_CONFIG_FOLDER_PATH\actifile_googlemail.conf --device-name=YOUR_DEVICE_NAME --cache-dir=YOUR_CACHE_FOLDER_PATH
Example:

Step 5. Open the Actifile Portal portal and select Deployment > Installed Devices. Your device will appear in the list under the name you chose earlier.
Old interface:

New interface:
.webp?width=688&height=207&name=image-png-Feb-12-2025-11-53-17-1275-AM%20(1).webp)
You have completed a one-time scan of your cloud storage.