JoinGrove

Install on Chromebook

Source: docs/get-started/install-chromebook.md
Generated: 01/09/2026

Use JoinGrove on Chromebooks via browser, PWA install, and a backend REH server.

Key Concepts

  • What: Chromebook users run JoinGrove in the browser (Agents UI) with a Linux VM or remote server providing the backend.
  • Why: Chromebooks dominate education in many Global South markets — browser-first is required.
  • Related: Full tutorial (browser-chromebook.md), PWA install (install-pwa.md).

API / Reference

Step Command / ID Purpose
REH server npm run server Backend on Linux VM or cloud VM
Agents in browser npm run sessions-web Agent-first UI on port 8081
PWA install joingrove.installPwa Add to Chrome shelf
Run anywhere wizard joingrove.runAnywhereWizard Guided setup
Classic in browser Append ?classic=true to URL VS Code workbench in tab

Setup & Installation

  1. Provision a Linux backend (school VM, cloud $5 server, or Chromebook Linux container).
  2. On the server: clone JoinGrove → npm run build-fast → npm run server or npm run sessions-web.
  3. On Chromebook: open the server URL in Chrome.
  4. Command Palette (in browser session) → Install JoinGrove as App (PWA) (joingrove.installPwa).

Code Examples

On the backend server:

npm run build-fast
npm run sessions-web

On Chromebook, open:

http://YOUR_SERVER_IP:8081

Smoke check:

npm run smoke-run-anywhere

Next: Read the full Chromebook tutorial for tunnel and low-bandwidth tips.

How It Connects