StackieAlpha Preview

Install

Installation guide for Stackie

Stackie installs stackie and stackied to ~/.stackie/bin/. The installer writes to your user profile instead of system package-manager directories.

Installing or using Stackie is governed by the current Stackie Terms, stackie EULA, stackied EULA, and Privacy Policy.

macOS (ARM64 and x86_64)

Supports Apple Silicon (M1–M4) and Intel Macs running macOS 11 (Big Sur) or later.

Run in Terminal:

curl -fsSL https://stackie.dev/install.sh | sh

What this does:

  • Downloads stackie and stackied for your architecture
  • Verifies SHA256 checksums before installing
  • Installs to ~/.stackie/bin/
  • Adds ~/.stackie/bin to your shell PATH

Verify installation:

stackie --version

After install, you may need to run source ~/.zshrc (or source ~/.bashrc) to use stackie in your current terminal session.

Linux (x86_64 and ARM64)

Statically linked musl binary — works on Ubuntu 20.04+, Debian, Fedora, Arch, and others. No glibc dependency.

Run in your shell:

curl -fsSL https://stackie.dev/install.sh | sh

What this does:

  • Downloads static musl binaries for your architecture
  • Verifies SHA256 checksums before installing
  • Installs to ~/.stackie/bin/
  • Adds ~/.stackie/bin to your shell PATH

Ubuntu 23.10+ note: Ubuntu 23.10+ restricts unprivileged user namespaces, which are required for some Stackie sandbox features. You may need to configure AppArmor. See the security architecture page for details.

Windows (x86_64)

Requires Windows 10 or later (64-bit). The installer writes to your user profile. PowerShell 5.1+ is pre-installed on Windows 10+.

Run in PowerShell:

powershell -c "irm stackie.dev/install.ps1 | iex"

What this does:

  • Downloads stackie.exe and stackied.exe
  • Verifies SHA256 checksums using Get-FileHash
  • Installs to %USERPROFILE%\.stackie\bin\
  • Adds the install directory to your user-level PATH (registry)

Windows Defender note: Windows Defender SmartScreen may prompt on first run because the binaries are downloaded from the internet. Click “More info” then “Run anyway” to proceed. See the security architecture page for details on Windows sandboxing.

Inspecting the Script Before Running

If you prefer to review the install script before piping it to your shell:

macOS / Linux:

curl -fsSL https://stackie.dev/install.sh -o install.sh
less install.sh    # review
sh install.sh

Windows (PowerShell):

irm stackie.dev/install.ps1 -OutFile install.ps1
notepad install.ps1    # review
.\install.ps1

Updating

Once installed, use the built-in update command to stay current. This updates both binaries atomically.

stackie update

To install a specific version:

stackie update --version 0.9.0

Uninstalling

macOS / Linux:

# Remove binaries and data
rm -rf ~/.stackie

# Remove PATH entry from your shell rc file
# Edit ~/.zshrc or ~/.bashrc and delete the
# # stackie start ... # stackie end block

Windows (PowerShell):

# Remove binaries and data
Remove-Item -Recurse -Force "$env:USERPROFILE\.stackie"

# Remove PATH entry
$path = [Environment]::GetEnvironmentVariable('PATH','User')
$newPath = ($path -split ';' | Where-Object { $_ -notlike "*\.stackie\bin*" }) -join ';'
[Environment]::SetEnvironmentVariable('PATH', $newPath, 'User')