Skip to content

feat(local): port check and a shared-host port block next to other stacks - #6

Merged
agus-darmawan merged 1 commit into
devfrom
feat/local-ports
Nov 5, 2026
Merged

agus-darmawan merged 1 commit into
devfrom
feat/local-ports

Conversation

@agus-darmawan

Copy link
Copy Markdown
Member

NETRA can now run on one machine next to Taksu, the Molly dashboard and the server monitoring without taking their ports. Replaces #1, now on top of dev.

  • scripts/local.sh up and start check the ports NETRA publishes (LAN port, and the tunnel port with the tunnel overlay) before starting, and stop with the compose project or program that holds a port. Ports already published by NETRA's own Caddy pass.
  • scripts/local.sh ports lists those ports and who holds them; doctor has the same check.
  • LOCAL.md, "Next to other stacks": a port registry for the Mac mini (4470 Molly, 4480 Taksu, 4490/4491 NETRA on 127.0.0.1; 80, 8080, 3000, 3100, 9090 left alone; Ollama 11434 shared) and the cloudflared ingress entry.
  • .env.local.example: the commented shared-host settings (NETRA_TUNNEL_PORT=4490, NETRA_LAN_PORT=4491, NETRA_LAN_BIND=127.0.0.1).

Defaults are unchanged (LAN 80, tunnel 8088), so a laptop at a site and the current tunnel keep working.

The LOCAL.md conflict with dev: the commands table keeps the new ports row and dev's logs [api|db|caddy|...].

Checked: shellcheck of every script the validate workflow checks; docker compose config of the local and tunnel files.

@agus-darmawan
agus-darmawan merged commit e12b095 into dev Nov 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant