gitwtfhub

wtf is nexternel?

reynsys/nexternel — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · vibe coderComplexity · 4/5Setup · hard

TL;DR

A self-hosted smart home system that reads sensors and controls switches over your own network using ESP32 devices, with a web dashboard for control.

Mindmap

mindmap
  root((Nexternel))
    What it does
      Self-hosted smart home
      Sensor monitoring
      Relay control
    Tech stack
      React dashboard
      Fastify API
      Node-RED
      PostgreSQL
      InfluxDB
    Use cases
      Home automation
      ESP32 devices
      MQTT messaging
    Audience
      Home automation hobbyists
      Self-hosters
    Setup
      Docker Compose
      Ubuntu server
      dot env config

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor sensors and control relay switches around your home from a self-hosted dashboard.

REASON 2

Connect ESP32 devices over MQTT to report sensor data and receive on and off commands.

REASON 3

Store a history of sensor readings and build automation rules with Node-RED.

REASON 4

Run an entire home automation stack on a single Linux server without relying on a cloud provider.

What's in the stack?

TypeScriptReactFastifyNode-REDPostgreSQLInfluxDBMQTTDocker

How it stacks up

reynsys/nexternel0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity4/54/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires an always-on Ubuntu Linux server, Docker, and manual configuration of passwords, secrets, and MQTT credentials.

No license is stated in the README, so usage rights are unclear.

Wtf does this do

Nexternel is a smart home system you run yourself on your own Linux server at home, instead of relying on a company's cloud service. It watches sensors and controls relays, which are switches that turn devices on and off, all over your own local network. Small ESP32 microcontroller devices, cheap Wi-Fi chips often used in DIY electronics, send sensor readings and switch states over a messaging system called MQTT. A tool called Node-RED takes that data, stores a history of it in a database called InfluxDB, and can run automation rules. A web dashboard lets you see everything and control your devices, backed by an API server, with a PostgreSQL database keeping track of users, devices, rooms, and how your dashboard is laid out. Everything runs inside Docker containers, a way of packaging software so each piece runs in its own isolated environment, started together with a single command. This means you do not need to separately install the messaging system, the databases, or the automation tool on your server, Docker handles all of that for you. Setting it up means getting an Ubuntu Linux server on your home network with about 2 gigabytes of memory, installing Docker on it, and copying the project files over, either with git or by uploading them with an SFTP tool like FileZilla. You then create a configuration file with passwords and secrets, generate a password file for the messaging system, and start everything with one command. After that you create an admin account, connect Node-RED to the messaging system, and log into the web dashboard. Connecting actual ESP32 hardware is an optional final step, and the project includes example configurations for a living room sensor and relay setup and a four relay garden board. The dashboard itself shows a customizable grid of widgets such as sensor readings, relay switches, gauges, a clock, and weather, arranged across multiple tabs, and lets you edit devices, rooms, and automations from a settings area.

Yoink these prompts

Prompt 1
Walk me through installing Docker and setting up Nexternel on an Ubuntu server.
Prompt 2
Explain how ESP32 devices, MQTT, and Node-RED work together in this project.
Prompt 3
Help me create the .env file and generate the required secrets for Nexternel.
Prompt 4
Show me how to connect and configure a new ESP32 device with this dashboard.

Frequently asked questions

wtf is nexternel?

A self-hosted smart home system that reads sensors and controls switches over your own network using ESP32 devices, with a web dashboard for control.

What language is nexternel written in?

Mainly TypeScript. The stack also includes TypeScript, React, Fastify.

What license does nexternel use?

No license is stated in the README, so usage rights are unclear.

How hard is nexternel to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is nexternel for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.