Beta Apache 2.0 CI on every PR

Node-RED Control Center

The operations layer Node-RED was missing.

A single Go binary with an embedded React dashboard. Run it alongside Node-RED to get authentication and RBAC, scheduled backups, live log streaming, configuration editor, npm library and environment management — without touching Node-RED itself.

What nrcc is

Operations, not a Node-RED replacement.

Node-RED is brilliant for flows, but day-to-day operation usually means SSH-ing in, editing settings.js by hand, juggling tarballs for backups, and tailing log files. nrcc gives you a clean control plane: a single Go binary with an embedded React UI, JSON file storage, and a process manager that supervises Node-RED.

It connects to your existing Node-RED installation, never replaces it. Operators get visibility, an audit-friendly admin surface, and least-privilege access without changing the runtime.

Stack

  • Go 1.25
  • Chi router
  • JWT + bcrypt
  • Cobra CLI
  • React 19
  • Vite 8
  • TanStack Query 5
  • Zod
  • Tailwind + daisyUI
  • Vitest

One static binary with the React UI embedded via //go:embed. Cross-compiled on every tag to Linux amd64/arm64/armv7, macOS amd64/arm64, and Windows amd64 — plus a multi-arch Docker image.

What works today

A full operations surface in beta.

The MVP scope is feature-complete and nrcc is in a hardening phase. Every item below is shipped, runs in a 225-test Vitest suite, and is exercised by Go tests and the backend/frontend CI gates on every PR.

Backend

Auth, RBAC, lockouts

JWT login with bcrypt hashing, admin/viewer roles, and a last-admin guard so you can never lock yourself out.

Process manager

Supervises Node-RED with restart, status, and uptime tracking. Native or Docker, decided at install time.

Backups & restore

Manual + scheduled snapshots (cron), tar.gz archives, integrity checks, pre-restore safety backup, retention policies.

Live log buffer

Ring buffer of Node-RED stdout/stderr with level filtering, SSE streaming endpoint, and a clear/download path.

Settings editor

Validated config editor that round-trips through real settings.js with automatic backup before save.

Self-update detection

Polls GitHub Releases for new nrcc versions, surfaces the upgrade in the UI, and applies it with a guarded flow.

Frontend

Dashboard

CPU, memory, disk, uptime, host status, Docker status, plus quick actions for restart and "open Node-RED".

Flow viewer

List, inspect, and export flows. Pattern analysis surfaces common smells without leaving the UI.

Library & env management

Install / search / remove npm packages and manage Node-RED environment variables with encryption at rest.

Operations

Single binary CLI

nrcc install / uninstall / portless / version — Cobra-powered CLI cross-compiled on every tag.

systemd installer

sudo nrcc install creates the service, user, data dir, and starts it. Interactive prompts when running in a TTY, sane defaults otherwise.

Portless integration

Optional install hook for Portless — replaces raw :3001 URLs with HTTPS .localhost names and adds LAN / Tailscale sharing.

Quick start

Three commands to a local control plane.

  1. 01
    Clone git clone https://github.com/fgjcarlos/nrcc.git && cd nrcc
  2. 02
    Build the binary (frontend + Go) make build
  3. 03
    Run it ./nrcc

Prefer the one-liner installer with systemd integration? curl -fsSL https://raw.githubusercontent.com/fgjcarlos/nrcc/main/scripts/install.sh | sh — full options in the README.