Installing

Installing

Open this in the handset's own browser, over plain HTTP, and tap the install link:

http://berryssh.cobanov.run/

To host it yourself, use python3 tools/ota_server.py out — not a generic static server, which sends the wrong MIME type and makes the handset show the descriptor as text instead of installing it, with no error.

Any host you use must not redirect HTTP to HTTPS. The device cannot do modern TLS, so such a hostname is simply unreachable from it.

Connecting

New, then fill in:

Field
Host, Port, User	The server.
Password	Leave Save password off and it asks at connect time instead of storing it unencrypted.
Private key	Paste an OpenSSH Ed25519 key — the whole file.
Terminal size	8x14 = 60 columns, 6x11 and 6x9 = 80.
The three bridge fields	Only for remote servers.

A key is tried first, the password used as a fallback, so setting both is useful.

ssh-keygen -t ed25519 -N '' -f phone_key
cat phone_key.pub >> ~/.ssh/authorized_keys

Ed25519 only, unencrypted only. RSA needs BigInteger, which CLDC has not; passphrases need primitives this client has no other use for.

Host keys

On first contact berryssh shows the fingerprint. Compare it against ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub before accepting — same format, directly comparable.

If a stored key later changes, berryssh refuses and offers no way past. If you rebuilt the server, delete the saved connection and recreate it.

In a session

Menu key: Ctrl (arms the next key), Esc, Page up/down for 500 lines of scrollback, Keys (shows raw key codes — a diagnostic), Full screen, Reconnect, Disconnect, Quit.