Chat over SSH.

go get



Custom SSH server written in Go. Instead of a shell, you get a chat prompt.


Join the party:

$ ssh

(Apologies if the server is down.)

Quick Start

  ssh-chat [OPTIONS]

Application Options:
  -v, --verbose   Show verbose logging.
  -b, --bind=     Host and port to listen on. (
  -i, --identity= Private key to identify server with. (~/.ssh/id_rsa)

Help Options:
  -h, --help      Show this help message

After doing go get on this repo, you should be able to run a command like:

$ ssh-chat --verbose --bind ":2022" --identity ~/.ssh/id_dsa

To bind on port 22, you'll need to make sure it's free (move any other ssh daemons to another port) and run ssh-chat as root (or with sudo).

ssh-chat on Docker

You can run ssh-chat using a Docker image without manually installing go-lang:

$ docker pull alvin/ssh-chat
$ docker run -d -p host machine port):2022 --name ssh-chat alvin/ssh-chat

Or you can build your own image:

$ docker build -t (your-docker-username)/ssh-chat .

then run it:

$ docker run -d -p host machine port):2022 --name ssh-chat (your-docker-username)/ssh-chat


If you're developing on this repo, there is a handy Makefile that should set things up with make run.


  • Welcome message.
  • set term width properly
  • client map rather than list
  • backfill chat history
  • tab completion
  • /ban
  • /ban by ip
  • /help
  • /about
  • /list
  • /nick
  • pubkey fingerprint
  • truncate usernames
  • rename collision bug
  • op ops on join
  • piped stdout bug
  • saner sanitizing of inputs (version string, allow space/period)
  • Some tests.
  • More tests.
  • Even more tests.
  • Lots of refactoring
    • Pull out the chat-related stuff into isolation from the ssh serving stuff