Files
ferrum/scripts/windows/uninstall-service.ps1
Anand 7d3a1fa134 Add git hygiene, screenshots, and cross-platform deployment tooling
- .gitignore/.dockerignore: cover Go build artifacts, env files, logs,
  editor/OS cruft, and local runtime data (sqlite db/secret, config.yaml).
- README: add a Screenshots section (captured against a mock Proxmox
  cluster) and a Deploying a release build section.
- LICENSE: MIT.

Deployable binaries:
- cmd/ferrum: -version flag with build-time version/commit/date via
  -ldflags; -log-file flag (Windows services don't capture stdout/stderr
  the way systemd does); native Windows Service Control Manager support
  (service_windows.go) so ferrum.exe manages its own start/stop lifecycle
  under a Windows service, same graceful-shutdown path SIGTERM already used
  on Linux.
- packaging/systemd/ferrum.service: hardened systemd unit.
- scripts/build.sh, build.ps1: cross-compile linux/windows/darwin x
  amd64/arm64, package as .tar.gz/.zip with an install script and
  checksums.txt.
- scripts/linux/install.sh, uninstall.sh: create a dedicated system user,
  install the binary, seed /etc/ferrum/config.yaml, enable + start the
  systemd service.
- scripts/get.sh: one-line curl-pipeable installer (get.docker.com style)
  that resolves the latest release, verifies its checksum, and hands off
  to install.sh.
- scripts/windows/install-service.ps1, uninstall-service.ps1: register/
  remove the self-managing Windows service.
- .github/workflows/release.yml: publish all platform archives + checksums
  as GitHub Release assets on a vX.Y.Z tag push.
- .github/workflows/ci.yml: go vet/build/test, frontend lint/test/build,
  and shell-script syntax checks on push/PR.
2026-09-03 13:38:12 +05:30

42 lines
1.1 KiB
PowerShell

#requires -RunAsAdministrator
<#
.SYNOPSIS
Stops and removes the "Ferrum" Windows service.
.DESCRIPTION
Configuration and data under ProgramData\Ferrum are kept by default —
pass -Purge to also delete them and the installed binary.
.EXAMPLE
.\uninstall-service.ps1
.EXAMPLE
.\uninstall-service.ps1 -Purge
#>
[CmdletBinding()]
param(
[switch]$Purge,
[string]$InstallDir = (Join-Path $env:ProgramFiles "Ferrum"),
[string]$DataDir = (Join-Path $env:ProgramData "Ferrum")
)
$ErrorActionPreference = "Stop"
$existing = Get-Service -Name Ferrum -ErrorAction SilentlyContinue
if ($existing) {
Write-Host "==> Stopping service 'Ferrum'"
Stop-Service -Name Ferrum -Force -ErrorAction SilentlyContinue
& sc.exe delete Ferrum | Out-Null
} else {
Write-Host "==> No 'Ferrum' service registered"
}
if ($Purge) {
Write-Host "==> Removing $InstallDir and $DataDir"
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue $InstallDir
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue $DataDir
} else {
Write-Host "==> Keeping $InstallDir and $DataDir (pass -Purge to remove them)"
}
Write-Host "==> Done."