Skip to content

Document running Swarmforge on Windows under WSL - #90

Merged
CrypticSwarm merged 1 commit into
masterfrom
installation-documentation
Sep 25, 2026
Merged

CrypticSwarm merged 1 commit into
masterfrom
installation-documentation

Conversation

@CrypticSwarm

Copy link
Copy Markdown
Owner

Windows had no install path. The Makefile recipes need bash and the launcher relies on POSIX-only calls, so native Windows shells cannot run Swarmforge; it runs inside a WSL 2 Ubuntu distro with Docker Desktop as the daemon.

  • docs/windows.md starts from a machine with Docker Desktop installed: installing or checking an Ubuntu distro, wiring Docker Desktop's WSL integration to it, confirming docker reaches Docker Desktop, and installing git, make, and python3. It then hands off to the ordinary installation steps.
  • docs/installation.md gains a Prerequisites section listing what the host needs, which was not written down anywhere.
  • The README's Installation section and the docs index point at both pages.

Windows had no install path: the Makefile recipes need bash and the
launcher relies on POSIX-only calls, so native shells cannot run it. The
new page walks from a machine with Docker Desktop to an Ubuntu distro
wired to it, then hands off to the ordinary installation steps.

The host prerequisites were not written down anywhere, so installation
gains a section listing them, and the README and docs index point at
both pages.
@CrypticSwarm
CrypticSwarm merged commit 473670b into master Sep 25, 2026
4 checks passed
@CrypticSwarm
CrypticSwarm deleted the installation-documentation branch September 25, 2026 20:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant