Skip to content

Host Machine Setup

Set up your development environment directly on your host machine without Docker.

Prerequisites: Complete the common setup steps first (API keys and repository cloning).

Overview

Getting a working setup when running in your base host can be difficult. Use the /install command with your agent of choice to help translate and walk through the process appropriate for your host. It is HIGHLY recommended you perform this action while in plan mode or in a mode that requires explicit permission for actions.

Platform-Specific Notes

macOS

  • Use Homebrew for package management
  • Some tools may require Xcode Command Line Tools: xcode-select --install
  • M1/M2 users: All tools are ARM64 compatible

Linux

  • Ubuntu/Debian users should use apt-get
  • Fedora/RHEL users should use dnf/yum
  • May need build tools: sudo apt-get install build-essential

Windows (WSL2)

  • Use Ubuntu WSL2 for best compatibility
  • Follow Linux installation steps
  • Access application at http://localhost:35806 from Windows browser
  • Docker Desktop with WSL2 backend recommended if switching to devcontainer

Verification Checklist

After completing setup, verify everything works:

  • [ ] node --version shows v22.x or higher
  • [ ] bun --version shows installed version
  • [ ] python3 --version shows 3.12 or higher
  • [ ] uv --version shows installed version
  • [ ] make web starts the sandbox application
  • [ ] curl http://localhost:35806 returns HTML content
  • [ ] Browser shows Raccoon Rocket Lab at http://localhost:35806
  • [ ] make web-down successfully stops services

Next Steps

Once your host environment is set up:

  1. Return to setup overview
  2. Review the workshop overview
  3. Explore the concepts and tools documentation

Additional Resources