To install the Docassemble Docker image on Windows 11 Pro, you need to install Docker Desktop, configure it to use the WSL 2 backend, and execute the standard Docker run command.

Here is the exact step-by-step procedure to get it up and running.

System Requirements:

Before starting, ensure your system fulfills the necessary resource limits:

Storage: At least 40GB of free hard drive space (Docassemble takes up about 20GB and requires an additional 20GB of free space to run smoothly).

Memory: Minimum 4GB of RAM.

Step 1: Install and Configure Docker Desktop Download https://docs.docker.com/desktop/setup/install/windows-install/ the Docker Desktop for Windows Installer.

Run the downloaded.exe file.

Ensure the option to “Use WSL 2 instead of Hyper-V” is checked when prompted during installation.

Follow the on-screen instructions, finish the setup, and restart your computer.

Launch Docker Desktop, accept the subscription service agreement, and leave it running in the background.

Step 2: Run the Docassemble Container

Once Docker is active, open Windows PowerShell or the Command Prompt as an Administrator and execute the appropriate command based on your port availability:

Option A: Run on default ports (Recommended). If your machine is not using ports 80 (HTTP) or 443 (HTTPS) for other web servers, run:

docker run -d -p 80:80 -p 443:443 --restart always --stop-timeout 600 jhpyle/docassemble

Note: –stop-timeout 600 is critical for Docassemble because it needs time to safely shut down its internal databases and SQL services when you stop the container.