Installation

Get GetWebstack installed in under 5 minutes.

---

Prerequisites

You need:

• Docker (20.10.0+) - Download
• Git (2.30+) - Download
• A supported AI coding agent for gws init / /gws-setup — any one of: Claude Code, GitHub Copilot CLI, OpenAI Codex CLI, Cursor, Amp.

No AI agent? Every other GWS command works without one. You'll hand-author gws.json and use gws config import instead of /gws-setup. See Zero-Config Setup with AI → Manual escape hatch.

---

Install

macOS / Linux

# Install CLI + AI skills (/gws-setup, /gws-up, /gws-status, /gws-down, /gws-debug)
curl -sSL https://getwebstack.com/install.sh | bash

Windows (PowerShell)

# Install CLI + AI skills (/gws-setup, /gws-up, /gws-status, /gws-down, /gws-debug)
irm https://getwebstack.com/install.ps1 | iex

Using WSL2? Run the macOS / Linux command above inside your WSL2 terminal instead.

# Verify installation
gws --version

# Authenticate
gws login

The install script also symlinks the GWS skills into ~/.claude/skills/ and ~/.agents/skills/ so any supported AI agent picks them up automatically. Re-run gws skills install (or gws update) at any time to refresh.

That's it! You're ready to start.

Next step: read Zero-Config Setup with AI for the headline workflow, or jump straight into the Quick Start.

Troubleshooting

Docker not running

Start Docker Desktop or run sudo systemctl start docker (Linux).

Port already in use

sudo lsof -ti:8080 | xargs kill -9