SUPPORT

Get Terrarium running.

Start with the local setup guide. If the problem remains, send the exact command, error, and system details.

Start here

npx --yes terrarium-watch@latest start .

The terminal edition of Terrarium requires Node 22.12 or newer. The Mac app and Windows preview include their runtime and need no separate Node installation. The setup guidecovers install, replay, snapshots, updates, and what the watch reads.

Before you email

  1. For the Mac app or Windows preview, confirm the version in About Terrarium, choose your repository, and note any message in the app. Use the terminal checks below only for the terminal edition.
  2. For a Windows install issue, include your Windows version, the displayed publisher, and the exact installer or SmartScreen message. The expected publisher is GRAINWORK LLC. See the Windows setup guide for signature and checksum checks.
  3. Run npx terrarium-watch@latest doctor . to verify the repository, detected local stores, running watch, and privacy boundary without changing anything.
  4. Run npx --yes terrarium-watch@latest start . --no-open and open the printed localhost URL.
  5. Copy the exact command and terminal error.
  6. Include your operating system and Terrarium version, plus your Node version if using the terminal edition.
  7. Say whether the map opened, repository files appeared, and agent activity arrived.

Do not send a repository, recording, credential, or agent transcript unless it is needed and you are authorized to share it. Screenshots can contain file names, so check them first.

Contact

Email hello@terrarium.watch. For a possible vulnerability, use the security reporting guideinstead.