docker / docker/scout-cli

Add PowerShell installation script for Windows users

Open
#202 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
454
Forks
134
PR merge metrics
No merged PRs in 30d

Description

Issue Description:

Currently, the Docker Scout CLI repository provides an automated Bash installation script (install.sh) for Linux and macOS users, but Windows users must either rely on Docker Desktop or perform manual installation steps.

However, many Windows users are experiencing Docker Desktop update failures specifically related to Docker Scout CLI updates (see docker/for-win#14807 and my workaround comment). This leaves Windows users with no automated installation option when Docker Desktop's built-in updater fails.

Proposed Solution:

I've created a PowerShell script that automates the Docker Scout CLI installation process for Windows users. The script:

  • Automatically detects CPU architecture (amd64/arm64)
  • Downloads the latest release from GitHub
  • Installs to the correct Windows directory (%USERPROFILE%\.docker\scout)
  • Updates the Docker configuration file with proper JSON formatting
  • Creates backups and handles edge cases safely

Repository: https://github.com/tataouinea/Repair-DockerScoutCLI

Benefits:

  1. Immediate value: Provides a workaround for the current Docker Desktop update issue affecting Windows users
  2. Long-term value: Gives Windows users parity with Linux/macOS automated installation, even after Docker Desktop issues are resolved
  3. Consistency: Follows the same approach as the existing Bash script for other platforms

Request:

Would the maintainers be interested in a PR that adds this PowerShell script to the repository? This would provide Windows users with the same automated installation experience that Linux and macOS users currently enjoy, and could serve as the official Windows installation method alongside the existing Bash script.

The script has been tested and successfully resolves the Docker Desktop update issue, but integrating it into the official repository would make it more discoverable and accessible to affected users.

I'm open to making any necessary modifications to the script to meet repository standards, such as:

  • Removing excessive confirmation prompts for a cleaner experience
  • Adjusting or removing the automatic backup functionality for the JSON configuration file
  • Any other changes to align with the project's coding standards and preferences

Thank you for considering this enhancement!

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by comparing the repository's existing install.sh with the proposed PowerShell script in tataouinea/Repair-DockerScoutCLI. Confirm how the script should handle architecture detection, GitHub downloads, the Windows installation directory, Docker configuration updates, and backups; done means an approved Windows installation path consistent with repository standards.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, github, powershell
Domain
cli
Issue type
Feature
Difficulty
3/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.