super-s-host

Runs a Super S host on a machine you reach over SSH: a server, a dev box, another computer. There's no account or cloud. The host listens on 127.0.0.1 only, and Super S reaches it through an SSH tunnel using your SSH key.

Use it from Super S

In Super S, open Machines → Add machine and type the SSH destination (user@host, ssh://user@host:2222, or an alias from ~/.ssh/config). Super S installs this package on that machine, starts the host, and connects.

Use it by hand

On the remote machine (Node.js 20 or later):

npm install -g --prefix ~/.super-s-host --allow-scripts=better-sqlite3,node-pty,@parcel/watcher @teodortrotea/super-s-host
~/.super-s-host/bin/super-s-host up

up starts the host, or restarts it after an update, and prints its connection info as JSON. On Linux with a systemd user session it runs as the super-s-host user service. Otherwise it runs as a background process, and Super S starts it again each time it connects.

| Command | What it does | | --- | --- | | super-s-host up | Start the host and print its connection info | | super-s-host status | Show whether the host is running | | super-s-host stop | Stop the host | | super-s-host logs | Print the host log |

The host's config, database and log live in ~/.super-s-host. The secret in config.json is the only credential, and the host accepts it only on the loopback interface.