summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 14 insertions, 5 deletions
diff --git a/README.md b/README.md
index 3ac3a4b..e5f7146 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,9 @@
-![backend](https://github.com/tsl0922/ttyd/workflows/backend/badge.svg) ![frontend](https://github.com/tsl0922/ttyd/workflows/frontend/badge.svg) [![Packaging status](https://repology.org/badge/tiny-repos/ttyd.svg)](https://repology.org/project/ttyd/versions)
+![backend](https://github.com/tsl0922/ttyd/workflows/backend/badge.svg)
+![frontend](https://github.com/tsl0922/ttyd/workflows/frontend/badge.svg)
+[![GitHub Releases](https://img.shields.io/github/downloads/tsl0922/ttyd/total)](https://github.com/tsl0922/ttyd/releases)
+[![Docker Pulls](https://img.shields.io/docker/pulls/tsl0922/ttyd)](https://hub.docker.com/r/tsl0922/ttyd)
+[![Packaging status](https://repology.org/badge/tiny-repos/ttyd.svg)](https://repology.org/project/ttyd/versions)
+![GitHub](https://img.shields.io/github/license/tsl0922/ttyd)
# ttyd - Share your terminal over the web
@@ -32,7 +37,8 @@ ttyd is a simple command-line tool for sharing terminal over the web.
- Install the snap: `sudo snap install ttyd --classic`
- Build from source (debian/ubuntu):
```bash
- sudo apt-get install build-essential cmake git libjson-c-dev libwebsockets-dev
+ sudo apt-get update
+ sudo apt-get install -y build-essential cmake git libjson-c-dev libwebsockets-dev
git clone https://github.com/tsl0922/ttyd.git
cd ttyd && mkdir build && cd build
cmake ..
@@ -59,12 +65,15 @@ USAGE:
OPTIONS:
-p, --port Port to listen (default: 7681, use `0` for random port)
-i, --interface Network interface to bind (eg: eth0), or UNIX domain socket path (eg: /var/run/ttyd.sock)
- -c, --credential Credential for Basic Authentication (format: username:password)
+ -U, --socket-owner User owner of the UNIX domain socket file, when enabled (eg: user:group)
+ -c, --credential Credential for basic authentication (format: username:password)
+ -H, --auth-header HTTP Header name for auth proxy, this will configure ttyd to let a HTTP reverse proxy handle authentication
-u, --uid User id to run with
-g, --gid Group id to run with
-s, --signal Signal to send to the command when exit it (default: 1, SIGHUP)
+ -w, --cwd Working directory to be set for the child program
-a, --url-arg Allow client to send command line arguments in URL (eg: http://localhost:7681?arg=foo&arg=bar)
- -R, --readonly Do not allow clients to write to the TTY
+ -W, --writable Allow clients to write to the TTY (readonly by default)
-t, --client-option Send option to client (format: key=value), repeat to add more options
-T, --terminal-type Terminal type to report, default: xterm-256color
-O, --check-origin Do not allow websocket connection from different origin
@@ -73,7 +82,7 @@ OPTIONS:
-B, --browser Open terminal with the default system browser
-I, --index Custom index.html path
-b, --base-path Expected base path for requests coming from a reverse proxy (eg: /mounted/here, max length: 128)
- -P, --ping-interval Websocket ping interval(sec) (default: 300)
+ -P, --ping-interval Websocket ping interval(sec) (default: 5)
-6, --ipv6 Enable IPv6 support
-S, --ssl Enable SSL
-C, --ssl-cert SSL certificate file path