WeTTY logo

WeTTY

  •  0 ratings
In category: Miscellaneous

About WeTTY

Terminal in browser over http/https.

  •   476  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: 478  
  •   36,000  
  •   634  
  •  Latest commit: Jan 15, 2023  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

More about WeTTY

WeTTY = Web + TTY.

All Contributors

Version Node Version Documentation License: MIT Twitter: cianbutlerx

Terminal access in browser over http/https

WeTTY

Terminal over HTTP and https. WeTTY is an alternative to ajaxterm and anyterm but much better than them because WeTTY uses xterm.js which is a full fledged implementation of terminal emulation written entirely in JavaScript. WeTTY uses websockets rather than Ajax and hence better response time.

Prerequisites

  • node >=14
  • make
  • python
  • build-essential

Install

yarn global add wetty

Usage

$ wetty --help
Options:
  --help, -h      Print help message                                   [boolean]
  --version       Show version number                                  [boolean]
  --conf          config file to load config from                       [string]
  --ssl-key       path to SSL key                                       [string]
  --ssl-cert      path to SSL certificate                               [string]
  --ssh-host      ssh server host                                       [string]
  --ssh-port      ssh server port                                       [number]
  --ssh-user      ssh user                                              [string]
  --title         window title                                          [string]
  --ssh-auth      defaults to "password", you can use "publickey,password"
                  instead                                               [string]
  --ssh-pass      ssh password                                          [string]
  --ssh-key       path to an optional client private key (connection will be
                  password-less and insecure!)                          [string]
  --ssh-config    Specifies an alternative ssh configuration file. For further
                  details see "-F" option in ssh(1)                     [string]
  --force-ssh     Connecting through ssh even if running as root       [boolean]
  --known-hosts   path to known hosts file                              [string]
  --base, -b      base path to wetty                                    [string]
  --port, -p      wetty listen port                                     [number]
  --host          wetty listen host                                     [string]
  --command, -c   command to run in shell                               [string]
  --allow-iframe  Allow wetty to be embedded in an iframe, defaults to allowing
                  same origin                                          [boolean]

Open your browser on http://yourserver:3000/wetty and you will prompted to login. Or go to http://yourserver:3000/wetty/ssh/<username> to specify the user beforehand.

If you run it as root it will launch /bin/login (where you can specify the user name), else it will launch ssh and connect by default to localhost. The SSH connection can be forced using the --force-ssh option.

If instead you wish to connect to a remote host you can specify the --ssh-host option, the SSH port using the --ssh-port option and the SSH user using the --ssh-user option.

Check out the Flags docs for a full list of flags

Docker container

To use WeTTY as a docker container, a docker image is available on docker hub. To run this image, use

docker run --rm -p 3000:3000 wettyoss/wetty --ssh-host=<YOUR-IP>

and you will be able to open a ssh session to the host given by YOUR-IP under the URL http://localhost:3000/wetty.

It is recommended to drive WeTTY behind a reverse proxy to have HTTPS security and possibly Let’s Encrypt support. Popular containers to achieve this are nginx-proxy and traefik. For traefik there is an example docker-compose file in the containers directory.

FAQ

Check out the docs

What browsers are supported?

WeTTY supports all browsers that xterm.js supports.

Author

πŸ‘€ Cian Butler butlerx@notthe.cloud

Contributing ✨

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Please read the development docs for installing from source and running is dev node

Thanks goes to these wonderful people (emoji key):


Cian Butler

πŸ’» πŸ“–

Krishna Srinivas

πŸ’»

acalatrava

πŸ’»

Strubbl

πŸ’»

Oleg Kurapov

πŸ’»

Boyan Rabchev

πŸ’»

Jimmy

πŸ’»

Luca Milanesio

πŸ’»

Anthony Jund

πŸ’»

mirtouf

πŸ’»

Bertrand Roussel

πŸ’»

Ben Letchford

πŸ’»

SouraDutta

πŸ’»

Koushik M.L.N

πŸ’»

Imuli

πŸ’»

perpen

πŸ’»

Nathan LeClaire

πŸ’»

Mihir Kumar

πŸ’»

Chris Suszynski

πŸ’»

Felix Bartels

πŸ’»

Jarrett Gilliam

πŸ’»

Harry Lee

πŸ’»

Andreas KlΓΆckner

πŸ’»

DenisKramer

πŸ’»

Vamshi K Ponnapalli

πŸ’»

Tri Nguyen

πŸ“–

Felix Pojtinger

πŸ“–

Neale Pickett

πŸ’»

Matthew Piercey

πŸ“–

Kasper Holbek Jensen

πŸ“–

Farhan Khan

πŸ’»

Jurre Vriesen

πŸ’»

James Turnbull

πŸ’»

Dean Shub

πŸ’»

lozbrown

πŸ’» πŸ’‘

sergeir82

πŸ’»

Kyle Lucy

πŸ’»

userdocs

πŸ“–

Janos Kasza

πŸ’»

Grant Handy

πŸ“–

Leszek BΕ‚aΕΌewski

πŸ’» πŸ“¦

This project follows the all-contributors specification. Contributions of any kind welcome!

Show your support

Give a ⭐️ if this project helped you!

πŸ“ License

Copyright Β© 2019 Cian Butler butlerx@notthe.cloud.
This project is MIT licensed.


Comments (0)

Please login to join the discussion on this project.

WeTTY Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

pCloud Lifetime

Popular Projects

FluxBB

in Social Networks and Forums
 33k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Libreddit

in Social Networks and Forums
 7k    0    1    0  

Dashboard

in Personal Dashboards
 6k    0    0    0  

Audiobookshelf

in Audio Streaming
 6k    0    1    0  

CasaOS

in Self-hosting Solutions
 5k    0    0    0  

Mediagoblin

in Photo and Video Galleries
 4k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Tube Archivist

in Automation
 3k    0    1    0  

OneDev

in Project Management
 2k    0    0    0  

iodine

in Proxy
 2k    0    0    0  

Alf.io

in Booking and Scheduling
 2k    0    0    0  

sysPass

in Password Managers
 1k    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

PassCheck logo
PassCheck cover

PassCheck

A web application featuring some handy password tools, incl…

Digital-Currency logo
Digital-Currency cover

Digital-Currency

Create your own Self-Hosted Digital Currency.

MailyGo logo
MailyGo cover

MailyGo

MailyGo is a small tool written in Go that allows to send H…