This guide describes installing the DeepSearch full stack on Windows using Docker (one-command bring-up).

1. Environment preparation

Ensure the machine meets:

• Hardware

  • CPU: minimum 2 cores; 4+ recommended
  • RAM: minimum 4 GB; 8 GB+ recommended

• OS: Windows 10 or later

• Software

  • Git: download and install with default options
  • Docker: Docker Desktop recommended; see below

Install Docker Desktop

On Windows, Docker Desktop works best with WSL 2 (Windows Subsystem for Linux 2) as the backend: better compatibility, lower overhead than LinuxKit, and avoids known “zombie container” issues.

1. Install WSL

On supported Windows (Windows 10 version 2004+ / build 19041+, or Windows 11), run wsl --install for a one-step WSL setup.

• Press Windows + S, search for PowerShell.

• Right-click Windows PowerShell → Run as administrator.

• Run:

  wsl --install
  

  When you see that changes will take effect after restart, reboot. First install may take a while.

Older Windows may need extra steps; see Install Linux on Windows with WSL.

2. Install Docker Desktop

• Download the Windows installer from the Docker Desktop site (choose AMD64 on x86). Prefer a recent version meeting:
  • Docker Engine 20.10+
  • Docker Compose v2.19.1+
• Run the installer: only check Use WSL 2 instead of Hyper-V and Add shortcut to desktop, then OK.
• Reboot when prompted.
• Open Docker Desktop after reboot; first launch may take 5–10 minutes.
• For trials you can use Continue without signing in; for ongoing use see Docker sign-in.

For errors or official steps, see Docker Desktop on Windows.

2. Install DeepSearch

1. Download the package (skip if you already have it)

• Download the matching architecture:

  x86_64: DeepSearch v0.1.6

  ARM64: DeepSearch v0.1.6

2. Docker Desktop: Virtual file shares

• Create an install folder, e.g. D:\DeepSearch.
• Docker Desktop → Settings (gear).
• Resources → File sharing: add your DeepSearch install path, click +, then Apply & restart.

3. Start DeepSearch

• Put the zip in the install folder and extract.

• Open Git Bash in the folder containing service.sh and verify Docker:

  docker info >nul 2>&1 && (echo Docker Desktop is running) || (echo Docker Desktop is not running)
  

  If not running, see Docker Desktop on Windows.

• To change the web UI port, see this guide.

• Locate and edit the .env.custom file in the deployment tool directory, then add the following configuration item according to your actual runtime environment:

IP=<local IP address of the machine running the deployment tool>

• Start:

  ./service.sh up
  

  Network issues may show “up Plugin + Sandbox Server failed”; run ./service.sh up again.

• On success you’ll see Local access: with a URL.

  More container details: deployment tool manual.

4. Open the app

Paste the Local access URL into your browser.

• You may see “Your connection is not private” because HTTPS uses a self-signed certificate. That warns the cert is not from a public CA, not necessarily that the site is unsafe.
• Use Advanced → proceed to the site.
• In Task space, select the DeepSearch agent.

3. FAQ

How to stop the service

./service.sh down