It can be used to run a specific TUI software instead of exposing the login screen to your whole computer. In our case, we are serving a XMPP console client.
The quickest and easiest way is to install
ttyd is from
your distro repo. On Debian, this is as easy as:
apt install ttyd
I recommend the newer version from Debian Backports since it has more features.
You can start
ttyd from the command line as soon as you
have installed it:
ttyd -p 7681 profanity
Then point the browser to
You can launch
ttyd with more options. To see them all,
ttyd from the command-line however is not
stable enough to serve WebCC to the public hence we need to save our
configuration to a file. Assumes that our console client will be Profanity, let’s start by creating a
configuration directory for
mkdir -p /etc/webcc
For easy access, we can put the help info of
ttyd in our
configuration file like so:
ttyd --help 2>&1 | sed -e 's/^/# /' | tee /etc/webcc/profanity.conf
Then inside the file, add this line at the bottom:
TTYD_OPTIONS="-d7 -i eth0 -p 7681 -m50 -O -b /muc profanity"
Notice that the option
-i above with
will be different for every machine. You can check what you have
You should check out the documentaion of
further details. You can clone the whole wiki to your machine with
git clone https://github.com/tsl0922/ttyd.wiki.git
You can modify the source code to add|remove features for your
The collection of patches is here.
If you would like to share your patches here, please do contact: xmpp:firstname.lastname@example.org?join
In the next chapter, we will use this file to launch WebCC with the init system.