Scan Microsoft365, Dropbox, and Google Cloud Services
      Back to home
      1. Knowledge Base
      2. Deploy the Cloud & NAS Agent
      3. Scan Microsoft365, Dropbox, and Google Cloud Services

      Deploy the Cloud Agent Locally with Docker

      This guide covers how to run a scan with Actifile using Docker on a Windows machine. It walks through configuring the agent, initiating the scan, and monitoring results in Docker and the Actifile portal.

      Run the scan

      Follow these steps to run the scan.

       

      Step 1. Follow this guide to install and configure Docker Desktop on your Windows machine. Ensure the Docker Desktop app is running before you pass to the next step.   

       

      Step 2. Download the configuration file for the app or apps 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. Check that all the config files you downloaded are in the same folder.

       

      Step 3. Open your command line interface and run the command below, replacing placeholders with your values. 

      • YOUR_CONFIG_FOLDER_PATH > the path to the folder containing the configuration file(s) you generated in step 2.
      • YOUR_HOSTNAME > choose a hostname that the agent will use to generate a unique ID for each scanned drive.

      Note: If you redeploy the agent for the same drive, ensure you use the same hostname; otherwise, the agent will treat the drive as a separate device.

      docker run -d -v YOUR_CONFIG_FOLDER_PATH:/conf -e AGENT_HOST_NAME=YOUR_HOSTNAME --init docker.io/actifile/cloudscanner

      Example:

      image-13

      This command will initiate the scanning process for all cloud apps simultaneously, provided the Actifile agent can locate the corresponding configuration files in the folder you specify.

      You can update the Docker image automatically to ensure you always use the most recent version of the Actifile agent. For instructions, go to the auto-update section.

       

      Step 5. Open the Docker Desktop app and navigate to the Containers tab. The Actifile Docker container will appear on the workspace. The agent will scan all available devices as long as the container’s status is running. To pause the scanning process, click the stop button. 

      image-21

       

      Step 6. Open the Actifile Portal portal and select Deployment > Installed Devices. Each scanned cloud application will appear in the list as a separate device. Verify that all desired applications are listed.

      Old interface:

      image-19-1

      New interface:

      image-png-Feb-12-2025-11-53-17-1275-AM

      Auto-update the agent

      You can automatically update images to ensure you are always running the latest version of the agent.

       

      Step 1. Before proceeding to the next step, ensure your Docker Desktop app is running.

       

      Step 2. Open your command line interface and run the following command, replacing the placeholder with your value.

      • YOUR_INTERVAL > the interval in seconds when the agent will pull the newest Docker image.
      docker run -d --name watchtower -v //var/run/docker.sock:/var/run/docker.sock docker.io/actifile/watchtower -i YOUR_INTERVAL --cleanup

      Example:

      image-12-1

      Note: We use Watchtower to update Docker container base images automatically. For more information, refer to Watchtower’s official documentation.

       

      Step 3. Open the Docker Desktop app and navigate to the Containers tab. The Watchtower Docker container will appear on the workspace. Watchtower will monitor updates as long as the container’s status is running.

      unnamed-4

      Now, Watchtower will automatically check for new images and restart the container with the same configurations.