JoinGrove

Install on Linux

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

Run JoinGrove on Linux — ideal for self-hosted campus servers and developer workstations.

Key Concepts

  • What: Linux install for dev machines and headless REH/campus Docker deployments.
  • Why: Most self-hosted campus and $5/month VM setups run Linux — JoinGrove targets this path heavily.
  • Related: Self-hosted campus (campus.md), Docker (docker-campus.md).

API / Reference

Mode Command Use case
Dev (Agents) npm run dev Local workstation
REH server npm run server Shared dev box / VM
Fast build npm run build-fast Low-spec campus VM
Docker campus docker compose -f docker/campus/docker-compose.yml up -d Bootcamp lab
Setup script npm run setup-self-hosted-server Automated REH install

Setup & Installation

  1. Install Node.js 24.13+, Python 3, build-essential (Debian/Ubuntu) or equivalent.
  2. Clone → npm install → npm run dev for workstation use.
  3. For campus server → npm run setup-self-hosted-server or Docker compose (see Code Examples).
  4. Command Palette → Set Up Self-Hosted JoinGrove Server… (joingrove.selfHostedWizard).

Code Examples

Workstation development:

npm install
npm run dev

Self-hosted campus (Docker):

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

Self-hosted setup script:

npm run setup-self-hosted-server

Next: Share the server URL with your cohort; students connect via browser or tunnel.

How It Connects