install.ps1 RawHistoryFolder
1# zot installer for Windows (PowerShell).
2#
3# Usage (in PowerShell):
4# iwr -useb https://raw.githubusercontent.com/patriceckhart/zot/main/install.ps1 | iex
5#
6# Or with arguments:
7# $env:ZOT_VERSION = "v0.0.1"
8# $env:ZOT_PREFIX = "$HOME\bin"
9# iwr -useb https://raw.githubusercontent.com/patriceckhart/zot/main/install.ps1 | iex
10#
11# Detects architecture, downloads the matching .zip from the GitHub
12# release, verifies the sha256 against checksums.txt, extracts zot.exe,
13# and moves it into $ZOT_PREFIX (defaults to $HOME\bin, added to PATH
14# via the User environment if missing).
15#
16# $env:GITHUB_TOKEN is optional for the public repo. Set it to a PAT
17# with `contents:read` scope if you hit GitHub API rate limits (or if
18# you are installing from a private fork); the script then uses it for
19# the version lookup and every download.
20
21
22[CmdletBinding()]
23param(
24 [string]$Version = $env:ZOT_VERSION,
25 [string]$Prefix = $env:ZOT_PREFIX
26)
27
28$ErrorActionPreference = "Stop"
29
30$owner = "patriceckhart"
31$repo = "zot"
32$binary = "zot"
33
34# Build Authorization header list once; used on every HTTP call so the
35# script works against private repos when $env:GITHUB_TOKEN is set.
36$headers = @{}
37if ($env:GITHUB_TOKEN) { $headers["Authorization"] = "Bearer $($env:GITHUB_TOKEN)" }
38
39if (-not $Version) { $Version = "latest" }
40if (-not $Prefix) { $Prefix = Join-Path $HOME "bin" }
41
42function Msg($m) { Write-Host "==> $m" -ForegroundColor Cyan }
43function Warn($m) { Write-Warning $m }
44function Die($m) { Write-Error $m; exit 1 }
45
46# ---- detect architecture ----
47
48switch -wildcard ($env:PROCESSOR_ARCHITECTURE) {
49 "AMD64" { $arch = "amd64" }
50 "ARM64" { $arch = "arm64" }
51 default { Die "unsupported arch: $($env:PROCESSOR_ARCHITECTURE)" }
52}
53
54# ARM64 Windows isn't shipped (see .goreleaser.yaml ignore rule) — fall
55# back to amd64 which runs fine under ARM64 emulation.
56if ($arch -eq "arm64") {
57 Warn "windows/arm64 is not published; falling back to amd64"
58 $arch = "amd64"
59}
60
61# ---- resolve version ----
62#
63# Resolve "latest" through the GitHub releases API. This works the same
64# on Windows PowerShell 5.1 and PowerShell 7+, unlike scraping the
65# /releases/latest redirect target: on PS7 the final URL lives at
66# $resp.BaseResponse.RequestMessage.RequestUri while on PS5.1 it is
67# $resp.BaseResponse.ResponseUri, and relying on either breaks on the
68# other runtime. The API returns the tag directly, so there is nothing
69# to scrape.
70
71if ($Version -eq "latest") {
72 $apiUrl = "https://api.github.com/repos/$owner/$repo/releases/latest"
73 # GitHub's API wants a User-Agent; Invoke-RestMethod sets one, but be
74 # explicit so corporate proxies that strip it don't trip a 403.
75 $apiHeaders = @{} + $headers
76 if (-not $apiHeaders.ContainsKey("User-Agent")) { $apiHeaders["User-Agent"] = "zot-installer" }
77 $apiHeaders["Accept"] = "application/vnd.github+json"
78
79 try {
80 $api = Invoke-RestMethod -UseBasicParsing -Headers $apiHeaders -Uri $apiUrl
81 } catch {
82 $status = $null
83 try { $status = [int]$_.Exception.Response.StatusCode } catch {}
84 if ($status -eq 404) {
85 Die "no published release found for $owner/$repo (the repo may have no releases yet)"
86 } elseif ($status -eq 401 -or $status -eq 403) {
87 Die "GitHub API request was rejected ($status). If the repo is private, set `$env:GITHUB_TOKEN to a PAT with contents:read; otherwise you may be rate-limited (try again later or set `$env:GITHUB_TOKEN)."
88 } else {
89 Die "could not resolve latest version: $($_.Exception.Message)"
90 }
91 }
92
93 $Version = $api.tag_name
94 if (-not $Version) {
95 Die "could not resolve latest version: GitHub API returned no tag_name for $owner/$repo"
96 }
97}
98
99if (-not $Version.StartsWith("v")) { $Version = "v$Version" }
100$verNum = $Version.TrimStart("v")
101
102# ---- download + verify + extract ----
103
104$archive = "${binary}_${verNum}_windows_${arch}.zip"
105$baseUrl = "https://github.com/$owner/$repo/releases/download/$Version"
106$archiveUrl = "$baseUrl/$archive"
107$checksumUrl = "$baseUrl/checksums.txt"
108
109$tmp = New-Item -ItemType Directory -Path (Join-Path $env:TEMP ("zot-install-" + [System.Guid]::NewGuid().ToString("N").Substring(0,8)))
110
111try {
112 Msg "downloading $archive"
113 Invoke-WebRequest -UseBasicParsing -Headers $headers -Uri $archiveUrl -OutFile (Join-Path $tmp $archive)
114
115 Msg "verifying checksum"
116 $checksumFile = Join-Path $tmp "checksums.txt"
117 Invoke-WebRequest -UseBasicParsing -Headers $headers -Uri $checksumUrl -OutFile $checksumFile
118 $expected = Get-Content -LiteralPath $checksumFile | ForEach-Object {
119 $line = $_.Trim()
120 if ($line) {
121 $parts = $line -split "\s+"
122 if ($parts.Count -ge 2 -and $parts[($parts.Count - 1)] -eq $archive) { $line }
123 }
124 } | Select-Object -First 1
125 if (-not $expected) { Die "no checksum for $archive in checksums.txt" }
126 $expectedHash = ($expected -split "\s+")[0]
127
128 $actualHash = (Get-FileHash -Path (Join-Path $tmp $archive) -Algorithm SHA256).Hash.ToLower()
129 if ($expectedHash.ToLower() -ne $actualHash) {
130 Die "checksum mismatch: expected $expectedHash, got $actualHash"
131 }
132
133 Msg "extracting"
134 Expand-Archive -Path (Join-Path $tmp $archive) -DestinationPath $tmp -Force
135
136 $exe = Join-Path $tmp "$binary.exe"
137 if (-not (Test-Path $exe)) { Die "archive did not contain $binary.exe" }
138
139 Msg "installing to $Prefix\$binary.exe"
140 New-Item -ItemType Directory -Path $Prefix -Force | Out-Null
141 Copy-Item $exe (Join-Path $Prefix "$binary.exe") -Force
142
143 # ---- PATH hint ----
144
145 $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
146 $parts = $userPath -split ";" | Where-Object { $_ }
147 if (-not ($parts -contains $Prefix)) {
148 Warn "$Prefix is not on your user PATH"
149 Warn "adding it for future sessions..."
150 [Environment]::SetEnvironmentVariable("Path", ($userPath.TrimEnd(";") + ";" + $Prefix), "User")
151 Warn "open a new terminal to pick up the change, or run:"
152 Warn " `$env:Path = `"$Prefix;`$env:Path`""
153 }
154
155 Msg "installed. run: zot --help"
156}
157finally {
158 Remove-Item -Recurse -Force $tmp -ErrorAction SilentlyContinue
159}