NemaRoom

Download

Windows x64 and Apple Silicon builds are on the latest release. On Windows, pick the installer or the portable ZIP. The ZIP unzips to Nema.exe, with no shortcuts or uninstaller. Both use ~/.nema/desktop. The app needs Git 2.31 or later already on the machine.

The host command is nema, from npm i -g @nema-project/nema@<locked version>. That number is the version both image: pins in the docker-compose.yml you fetched carry. Hub and web images are linux/amd64. docker-compose.yml is a fixed-name asset of the latest release, rendered with both images pinned to that release's version. Fetch it, check that both pins print the same version, write NEMA_IMAGE_TAG=<that version> into .env (keep an existing value and fetch releases/download/v<locked>/docker-compose.yml instead), then start them. The v0.1.6 file still opens with the template's "not an installable version" comment; the two pinned image: lines are what count. A lock older than v0.1.6 has no release asset; take raw.githubusercontent.com/Nema-Project/nema-room/v<locked>/docker-compose.yml instead. On Linux and macOS, export NEMA_UID and NEMA_GID first. To develop this repository, clone it and run the setup wizard.

# Hub and web, linux/amd64. The compose file is a fixed-name asset of the latest release; an existing NEMA_IMAGE_TAG in .env keeps its own version.
NEMA_FETCHED= NEMA_LOCKED= NEMA_UP= NEMA_INSTALLED=
NEMA_PIN=$(sed -n 's/^NEMA_IMAGE_TAG=//p' .env 2>/dev/null | tail -1)
NEMA_URL=https://github.com/Nema-Project/nema-room/releases/latest/download/docker-compose.yml
test -n "$NEMA_PIN" \
  && NEMA_URL=https://github.com/Nema-Project/nema-room/releases/download/v$NEMA_PIN/docker-compose.yml
{ curl -fsSL -o docker-compose.yml.download "$NEMA_URL" \
  || { test -n "$NEMA_PIN" && curl -fsSL -o docker-compose.yml.download \
    "https://raw.githubusercontent.com/Nema-Project/nema-room/v$NEMA_PIN/docker-compose.yml"; }; } \
  && mv docker-compose.yml.download docker-compose.yml && NEMA_FETCHED=1
# Prints the version only when hub and web agree, then locked when .env holds it. Stop if either is missing.
NEMA_VERSION=$(grep -o 'nema-room-hub:[0-9.]*' docker-compose.yml | head -1 | cut -d: -f2)
WEB_VERSION=$(grep -o 'nema-room-web:[0-9.]*' docker-compose.yml | head -1 | cut -d: -f2)
test -n "$NEMA_FETCHED" && test -n "$NEMA_VERSION" && test "$NEMA_VERSION" = "$WEB_VERSION" \
  && echo "$NEMA_VERSION"
test -n "$NEMA_FETCHED" && test -n "$NEMA_VERSION" && test "$NEMA_VERSION" = "$WEB_VERSION" \
  && { test -n "$NEMA_PIN" || printf '\nNEMA_IMAGE_TAG=%s\n' "$NEMA_VERSION" >> .env; } \
  && test "$(sed -n 's/^NEMA_IMAGE_TAG=//p' .env | tail -1)" = "$NEMA_VERSION" \
  && NEMA_LOCKED=$NEMA_VERSION && echo "locked $NEMA_LOCKED"
# Each step runs only if the one before it succeeded. Export NEMA_HUB_PORT and NEMA_DATA_HOST_DIR first if .env sets them.
export NEMA_UID="$(id -u)" NEMA_GID="$(id -g)"   # Linux and macOS only
NEMA_DIR=${NEMA_DATA_HOST_DIR:-$HOME/.nema/data}
test -n "$NEMA_LOCKED" && mkdir -p -m 700 "$NEMA_DIR" && test -w "$NEMA_DIR" \
  && NEMA_IMAGE_TAG=$NEMA_LOCKED docker compose up -d --wait && NEMA_UP=1
test -n "$NEMA_UP" && npm i -g "@nema-project/nema@$NEMA_LOCKED" && NEMA_INSTALLED=1
# Compose does not run the daemon; keep it running.
test -n "$NEMA_INSTALLED" \
  && NEMA_DATA_DIR=$NEMA_DIR nema daemon --hub "http://127.0.0.1:${NEMA_HUB_PORT:-4400}"

# Or build this repository from source
git clone https://github.com/Nema-Project/nema-room.git
cd nema-room
node scripts/setup.mjs --lang en