wetty v0.1.0

Dev tools

WeTTY — a terminal in your browser: a web front-end that opens an SSH session to a host over HTTP, so you can get a shell from anywhere without a native SSH client. Deployed as a host-networked, stateless Nomad service that connects to an SSH server you specify.

nomad-pack run wetty --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- wetty

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 5.4k ⚑ Report an issue

1 task http 3011 image wettyoss/wetty:latest tracks :latest image bumped today

Variables 10

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run wetty -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "wetty"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The WeTTY container image. Pin a tag in production.
image = "wettyoss/wetty:latest"

# Host port for the WeTTY web terminal (--port).
port = 3011

# SSH server WeTTY connects to (--ssh-host). Use host.docker.internal or a reachable hostname/IP.
ssh_host = "127.0.0.1"

# SSH server port (--ssh-port).
ssh_port = 22

# Default SSH username to pre-fill (--ssh-user). Empty = prompt for the username.
ssh_user = ""

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# Resources for the WeTTY task.
resources = {
    cpu    = 200
    memory = 128
  }

Name	Type	Default	Description
job_name	string	"wetty"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"wettyoss/wetty:latest"	The WeTTY container image. Pin a tag in production.
port	number	3011	Host port for the WeTTY web terminal (--port).
ssh_host	string	"127.0.0.1"	SSH server WeTTY connects to (--ssh-host). Use host.docker.internal or a reachable hostname/IP.
ssh_port	number	22	SSH server port (--ssh-port).
ssh_user	string	""	Default SSH username to pre-fill (--ssh-user). Empty = prompt for the username.
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 200 memory = 128 }	Resources for the WeTTY task.

Readme

wetty

WeTTY — a terminal in your browser. It serves a web front-end that opens an SSH session to a host over HTTP(S), so you can get a shell from any device without a native SSH client.

Single host-networked, stateless Nomad service that connects to an SSH server you specify.

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run wetty --registry=nomploy

Configure

Variable	Default	Description
`port`	`3011`	Web terminal port (`--port`).
`ssh_host`	`127.0.0.1`	SSH server to connect to (`--ssh-host`).
`ssh_port`	`22`	SSH server port (`--ssh-port`).
`ssh_user`	`""`	Pre-filled SSH username (`--ssh-user`); empty = prompt.
`image`	`wettyoss/wetty:latest`	Container image. Pin a tag in production.
`resources`	`{ cpu = 200, memory = 128 }`	Task resources.

Open the URL and log in with your normal SSH credentials or keys. Point ssh_host at a reachable host (the node itself, a bastion, etc.).

Security: WeTTY exposes shell access over the web. Keep it off the public internet or behind an authenticating reverse proxy with TLS, and prefer SSH keys over passwords.