JoinGrove

Self-Hosted Campus

Source: docs/self-hosted/campus.md
Generated: 01/09/2026

Run JoinGrove on a shared campus server — Docker, REH, or setup script on a low-cost Linux VM.

Key Concepts

  • What: Campus deployment hosts JoinGrove REH for an entire cohort — students connect via browser, PWA, or tunnel.
  • Why: Universities and bootcamps cannot require every student to compile VS Code locally on 8 GB machines.
  • Related: Docker integration (docker-campus.md), tutorial (self-hosted-campus.md), campus agents (agents.md).

API / Reference

Method Command / path
Docker Compose docker/campus/docker-compose.yml
Setup script npm run setup-self-hosted-server
REH server npm run server
Fast build npm run build-fast
Wizard joingrove.selfHostedWizard
Docker image joingroveSelfHosted.dockerImage
Default port 9888

Campus tier includes

Feature Detail
Self-hosted REH Shared agent sessions
Docker image One-command lab deploy
Tutorial packs Offline WhatsApp/USB distribution
PPP pricing ~$10/mo campus tier

Setup & Installation

  1. Provision Linux VM (2 GB+ RAM; 4 GB recommended).
  2. Command Palette on admin machine → Set Up Self-Hosted JoinGrove Server… (joingrove.selfHostedWizard).
  3. Or run Docker compose / setup script (see Code Examples).
  4. Share URL with students; they install PWA or use browser Agents UI.
  5. Distribute offline tutorials for low-bandwidth onboarding.

Code Examples

Docker campus:

docker compose -f docker/campus/docker-compose.yml up -d

Setup script:

npm run setup-self-hosted-server

Fast build before server deploy:

npm run build-fast
npm run server

Next: Read agents.md for multi-user agent patterns on shared REH.

How It Connects