Skip to content
AIV

Windows Docker Installation Guide for AIV

This guide walks you through downloading, installing, and configuring AIV 6 using Docker—from initial setup to optimizing memory for better performance.

What You’ll Learn

  • How to download and extract the AIV 6 Docker package
  • How to run AIV using Docker Compose
  • How to increase Docker memory allocation for large datasets
  • Where to access AIV after installation

Overview

The Docker deployment offers:

  • Quick setup — Run AIV with minimal configuration
  • Consistent environment — Same behavior across different machines
  • Easy management — Start and stop services with a single command

Prerequisites

Before you begin, ensure you have:

RequirementDetails
Operating SystemWindows with WSL2 enabled
DockerDocker Desktop installed
MemoryMinimum 16 GB RAM recommended
CPUMinimum 8 CPU cores recommended

Step 1: Download the AIV 6 Docker Package

  1. Go to the AIV download page.

  2. Click Download.

  3. The website automatically detects your operating system and selects the appropriate platform ( Windows, macOS, or Linux).

  4. Verify that the correct platform is selected (Windows in this case).

  5. If you are installing AIV using Docker on Linux, ensure that Docker is selected as the installation method.

    AIV download page with form and Submit button

  6. Enter the required information in the download form:

    • Enter your Work Email in the email field.
    • Click Get OTP.
    • An OTP will be sent to the email address you provided.
    • Enter the 6-digit OTP in the Enter OTP field.
    • Click Verify OTP.
    • If the OTP expires before verification,click Resend OTP to receive a new OTP.
    • After successful verification, the message “Email verified successfully!” is displayed, and you can proceed with the remaining fields,
    • Enter your Full Name.
    • Enter your Company Name.
    • Select For business use from the Usage Type dropdown.
    • Select your Country Code and enter your Phone Number (optional).

  7. Select the checkbox to confirm that you have read and accepted the AIV EULA.

  8. By selecting the checkbox, you also agree to receive communications from AIV.

  9. Click Download Docker and wait for the Docker package to finish downloading. Once the download is complete, extract the ZIP file to a folder of your choice (for example, E:\docker-aiv-main).

Step 2: Run Docker Compose

  1. Open Docker Desktop and ensure it is running.

  2. Open Command Prompt or PowerShell and navigate to the extracted folder. For example:

    E:\docker-aiv-main\docker-aiv-main

  3. Run the following command:

    docker compose up

    Terminal showing docker compose up command

  4. Wait for all containers to start. When you see a message indicating the application is ready, the setup is complete.

  5. Verify the containers in Docker Desktop → Containers and check the memory usage.

    Docker Desktop Containers view showing running AIV containers

Access AIV

Once the containers are running, open your browser and go to:

http://localhost:8080/aiv

You can now start using AIV.

Step 3: Increase Docker Memory Allocation

If Docker is using limited memory (e.g., 7.45 GB), increasing it to 16 GB improves performance for large datasets and complex visualizations. Follow the steps below only if you need more memory.

3.1 Stop Running Containers

Option A: Press Ctrl + C in the terminal where docker compose up is running.

Option B: Run this command in a new terminal from your project folder:

docker compose down

3.2 Locate the WSL Configuration File

  1. Open Docker Desktop.

  2. Click the Settings icon.

    Docker Desktop Settings icon

  3. Go to Resources.yyy

  4. Note the WSL configuration file path displayed (e.g., C:\Users\YourName\.wslconfig).

    Docker Resources showing WSL configuration file path

  5. Navigate to that folder in File Explorer and check if .wslconfig exists.

  6. If it does not exist, you will create it in the next step.

3.3 Create or Update .wslconfig

  1. Open your user profile folder: C:\Users\<YourUsername>\ (Replace <YourUsername> with your Windows username).

  2. Create a new file named .wslconfig with no file extension.

    • Open Notepad++ or any text editor, create the content below, and save as .wslconfig in C:\Users\<YourUsername>\.

  3. Add or update the following content:

    [wsl2]
memory=16GB
processors=8

    .wslconfig file content in Notepad++

  4. Save the file and close the editor.

3.4 Restart WSL and Start Docker

  1. Close Docker Desktop completely.

  2. Open Command Prompt or PowerShell and run:

    wsl --shutdown

  3. Start Docker Desktop again.

  4. Navigate to your project folder and run:

    docker compose up

  5. Verify the updated memory allocation in Docker Desktop → Container → Container memory usage.

    Docker Desktop Resources showing 16GB memory allocation

System Requirements Summary

ComponentMinimum
OSWindows with WSL2
DockerDocker Desktop
RAM16 GB
CPU8 cores

Important Notes

  • Always run docker compose down (or press Ctrl + C) before modifying the WSL configuration.
  • Increasing memory improves performance for large datasets and complex visualizations.
  • After changing .wslconfig, run wsl --shutdown and restart Docker Desktop for the changes to take effect.