Statically linked release for linux can be downloaded now, you can verify it's signature using gpg:

gpg --keyserver ha.pool.sks-keyservers.net --recv-keys DC066DDA23C989D4CA5577F27E37674BC59FFF5A
gpg --verify ttyd-static-amd64.asc

The static binary can be run directly without libc, no runtime dependencies is required. Currently, only amd64 version is available, more platforms is coming soon!

ChangeLog

• Fixed compatibility for OpenBSD (f6361caa50b921d376df3808365ea815f237e64a)
• Fixed README to generate SSL certificate with SAN field (4ced0c8006d9a3fa12ee593a9de26bb0bc272aef)
• Upgraded to xterm.js 2.7.0 (055463542fde5eddc21053d821d4206ce4dc6534)
• Do not reconnect if process exited (4e0801db8ef43d7e949df45f7343e71771dfb3f5)
• Ony fire resize event when it ends (4cbc7748cfc11071120ca5e7698fa0e2a4962a52)

Starting from this release, ttyd is avaliable from ppa:tsl0922/ttyd-dev for ubuntu 16.04 and later, view the instructions.

ChangeLog

• Added man page (d5c944a2e1c03e83d63380bf46b094e6a459c559)
• Fixed client count calculation (35c97df863f6eff64796359703e42a5125bb147a)
• Simplified docker alpine image building, image size reduced to ~7MB (f95d3debe87601bfff0d3597b0dc4f55f44f81be)
• Added debian/ dir for deb packaging (@hosiet, #48)
• Upgraded to xterm.js 2.5.0 (9cc5e4a03b934f43fa64c6ce0d0fe0279bfd27c7)
• --max-clients option: limit max clients (3580e80783022d1fd8baecc38ab8a00490c16b0c)

This release fixes some critical bugs, users are encouraged to upgrade, especially those who are using the basic authentication feature.

ChangeLog

• Added alpine docker image (@dduportal, #38)
• Fixed font-family issue for windows (#40, e6c0961b240785d1c2bc8de83d2e45f992002610)
• Added padding for terminal container (2c34c5230b4db42f5acc9b9fb16eac4760450584)
• Upgraded to xterm.js 2.4.0 with WebLinks support (5db15646c77fe719132ae129968e5c72a860360f)
• Supported for compiling under OpenBSD (@dohnuts, #44)
• Fixed an issue that can bypass basic authentication (4d31e534c0ec20582d91210990969c19b68ab3b0)
• Fixed potential segmentation fault (SIGSEGV) error (08ac6dc43cfa196180790cefe2d0b9af125063ad)

This release comes with some new features and bug fixes, and xterm.js has been upgraded to the latest version with huge performance improvements.

xterm.js 2.3.0 introduces a new option useFlowControl which is not enabled by default, you can enable it on ttyd with option: -t useFlowControl=true.

ChangeLog

• --index option: custom index.html path (c9ffa8a8d7d21ca3114b3bcd49fd8d4624723185)
• --browser option: open terminal with the default system browser (e4c4fea1cb973c5a00405097ae15df2d85bbe005)
• --signal-list option: print a list of supported signals (896ca9c44cb695904257065321846ce8cb30a95d)
• Shrinked docker image size (@dduportal, 8db5ca53e135bb4181503f87f9305c17ce826a99)
• Added support for listening on UNIX domain socket (#33, de75490d3ec594b42478d92d135ef12cb1fdb735)
• Improved base64 decode and utf8 handling on the client side (f0414d30d8e88e2ef55e1916c18726777fdcb1e3)
• Fixed command execution order issue (https://github.com/tsl0922/ttyd/pull/34#discussion_r99275241, ffdf56e440c802ea2d7a4ed38304c54700021fc1)
• Added confirm dialog for window closing (82148cd61397d238a195af4a47ac03cfea73a5c9)
• Upgraded to xterm.js 2.3.1 (62b2bb5510050b75b94c1c59b10b7b7d58a0288c)

ttyd works on windows now! The build instructions is here, since the output binary depends on msys runtime dll, you need to build it yourself.

NOTE: Native windows console programs may not work correctly due to pty incompatibility issues. As a workaround, you can use winpty as a wrapper to invoke the windows program, eg: ttyd winpty cmd.

ChangeLog

• OK to build ttyd on MSYS2 (41b64be11032cf1457ca32226526f39fdf4dbfaa)
• Upgrade to xterm.js 2.2.3 (dcacbd25af19b3b7a0b6219c5a8d53e9119805d5)

This release comes with SSL client certificate verification support, look at the README to learn how to use this feature.

ChangeLog

• Enable client certificate verification if ssl CA is given (15e2dd96a4776cb8ed87db381c939061054cd19a)
• openwrt: add build instruction with SDK (06b8074b1e63eeb647bbb114b0e6f1decfe06108)

ttyd has CJK (Chinese, Japanese, Korean) and IME support now! The new terminal emulator is based on Xterm.js, which is also used by Microsoft Visual Studio Code.

ChangeLog

• Fixed compile error on FreeBSD (@neelchauhan, bccf6a435db88e0b17e386b928cb0cbc9a514cbf)
• Re-implemented the base64 function without openssl (a16fdfdbd47a5dca1a939d6e7aa56cbabf2939c8)
• --client-option option: allows setting terminal preference on the server side (24c3f2a880df947f55f091d9b6486b349fa98eed)
• Moved the terminal emulator from hterm to xterm.js for CJK and IME support (#22)
• Show websocket connection error with overlay (fdcbd3512cfc326213f77c9127c1d895356225cd)

New Features

• --once option: accept only one client and exit on disconnection
• --readonly option: do not allow clients to write to the TTY
• --check-origin option: do not allow websocket connection from different origin
• HTTP Server header changed to ttyd, eg: ttyd/1.1.0 (libwebsockets/2.0.2)

Improvements

• Added check for lws_config.h, some version of libwebsockets may not have this header file
• libwebsockets : handle fragmented messages, this allows large input on the web
• OpenWrt Makefile: changed the openssl dependency to libopenssl

Initial release.

Features

• Build on libwebsockets with C for speed
• Full terminal emulation based on hterm
• SSL support based on OpenSSL
• Run any custom command with options
• Basic authentication support
• Cross platform: macOS, Linux, OpenWrt

Usage

USAGE:
    ttyd [options] <command> [<arguments...>]

VERSION:
    1.0.0

OPTIONS:
    --port, -p              Port to listen (default: 7681)
    --interface, -i         Network interface to bind
    --credential, -c        Credential for Basic Authentication (format: username:password)
    --uid, -u               User id to run with
    --gid, -g               Group id to run with
    --signal, -s            Signal to send to the command when exit it (default: SIGHUP)
    --reconnect, -r         Time to reconnect for the client in seconds (default: 10)
    --ssl, -S               Enable ssl
    --ssl-cert, -C          Ssl certificate file path
    --ssl-key, -K           Ssl key file path
    --ssl-ca, -A            Ssl ca file path
    --debug, -d             Set log level (0-9, default: 7)
    --version, -v           Print the version and exit
    --help, -h              Print this text and exit