Skip to main content
One command detects your OS, checks dependencies, downloads the latest release, and installs it.

​
macOS / Linux

Run this in your terminal: 
curl -fsSL https://raw.githubusercontent.com/dutch-casa/handhold/main/scripts/install-handhold.sh | bash
The installer handles macOS Gatekeeper for unsigned apps and prompts to set up optional dependencies like Docker or Podman for labs.

​
What the installer does

1

Detects your platform and architecture

Supports macOS (Apple Silicon and Intel) and Linux (x86_64 and ARM64).
2

Checks dependencies

Verifies Git is installed. Offers to install a container runtime (Podman or Docker) for labs that need services like Postgres or Redis.
3

Downloads the latest release

Fetches the appropriate installer from GitHub releases: .dmg for macOS, .deb or .AppImage for Linux.
4

Installs the app

On macOS: mounts the DMG and copies Handhold.app to /Applications/, then clears the quarantine flag so it opens without warnings.On Linux: installs via .deb package if using apt/dpkg, otherwise installs the AppImage to ~/.local/bin/.

​
macOS notes

Handhold is not notarized by Apple. The installer automatically runs xattr -cr /Applications/Handhold.app to clear the quarantine flag. If this fails, you’ll see a warning with manual instructions: 
sudo xattr -cr /Applications/Handhold.app
Or right-click Handhold.app → Open → click “Open” in the dialog.

​
Linux notes

The .deb package is preferred on Debian/Ubuntu systems. If no .deb is available for your architecture, the installer uses the AppImage and places it in ~/.local/bin/handhold. If ~/.local/bin is not on your PATH, add this to your shell profile: 
export PATH="$HOME/.local/bin:$PATH"

​
Windows

Run this in PowerShell: 
irm https://raw.githubusercontent.com/dutch-casa/handhold/main/scripts/install-handhold.ps1 | iex

​
What the installer does

1

Detects architecture

Supports x64 and ARM64.
2

Checks dependencies

Verifies Git is installed. Offers to install a container runtime (Podman or Docker) via winget.
3

Downloads the latest release

Fetches the MSI installer from GitHub releases.
4

Installs the app

Runs the MSI installer silently. May prompt for administrator privileges.

​
Windows notes

WebView2 is required and ships with Windows 11. On Windows 10, the installer includes an offline WebView2 installer. The installer uses winget to install optional dependencies like Git and container runtimes. If winget is not available, you’ll need to install these manually.

​
Optional dependencies

Lessons never require containers — only labs that spin up services like Postgres or Redis.
The installer asks if you want to install Docker or Podman. Podman is recommended because it’s lighter and doesn’t require a background daemon on macOS/Windows.

​
Installing Podman manually

brew install podman

​
Installing Docker manually

brew install --cask docker

​
Verify installation

After installation completes, launch Handhold: 
open /Applications/Handhold.app
You should see the Handhold window with the course library.

​
Next steps

Quick start

Watch your first lesson and complete a lab

Build docs developers (and LLMs) love

Get started for freeTalk to us