nomadnet-web

Web-based NomadNet running in tmux and presented via GoTTY.

Requirements

• Docker
• nginx (for HTTPS reverse proxy)

Quick Start

git clone https://git.rns.moscow/nomadnet-web
cd nomadnet-web
docker build -t nomadnet .
./run.sh

nginx

Copy nginx-nomadnet.conf to /etc/nginx/sites-available/nomadnet and adjust your domain name, then:

sudo ln -s /etc/nginx/sites-available/nomadnet /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Configuration

File	Purpose
gotty.conf	GoTTY preferences (font, theme, etc.)
docker-init.sh	Fixes volume permissions, drops to nomadnet user
entrypoint.sh	Starts tmux session with NomadNet, then GoTTY
index.html	Custom GoTTY frontend (favicon, resize fix)

Volumes

Volume	Path	Purpose
nomadnet_reticulum	/etc/reticulum	Reticulum identity and config
nomadnet_data	/etc/nomadnetwork	NomadNet data and settings

Key Bindings

Some default NomadNet key bindings are remapped to avoid browser conflicts:

Original	Remapped
Ctrl-N	Ctrl-V
Ctrl-A	Ctrl-Y
Ctrl-W	Ctrl-Z

Authentication

By default, GoTTY basic authentication is enabled with a placeholder credential. You must change the default username and password before exposing this to the internet.

Edit run.sh and set the GOTTY_CREDENTIAL environment variable:

-e GOTTY_CREDENTIAL=youruser:yourpassword \

For more robust authentication, consider replacing or supplementing basic auth with a reverse proxy solution such as Authelia or Authentik in front of nginx. Note that GoTTY basic auth may conflict with some proxy authentication middleware — if this occurs, disable GOTTY_CREDENTIAL and rely solely on the proxy-level authentication.

License

MIT