shellinabox/README.md
2015-06-11 10:57:38 +00:00

2.9 KiB

shellinabox

Join the chat at https://gitter.im/shellinabox/shellinabox

Build Status

This is unofficial fork of project Shell In A Box. Fork was created because original project is not maintained anymore and we cannot contact original repository owners.

Our aim is to continue with maintanince of shellinabox project. For list of recent changes please see CHANGELOG.md.

If you have any questions, issues or patches, please fell free to submit pull request or report an issue. You can also drop an email to original project issue #261 discusion from where this fork started.

About shellinabox

Shell In A Box implements a web server that can export arbitrary command line tools to a web based terminal emulator. This emulator is accessible to any JavaScript and CSS enabled web browser and does not require any additional browser plugins.

Shell In A Box preview

More information:

Build

For building shellinabox from source on Debian or RHEL based systems use commands listed below. This will create executable file shellinaboxd in project directory.

  1. Install dependencies

     apt-get install git libssl-dev libpam0g-dev zlib1g-dev dh-autoreconf
    

    or

    yum install git openssl-devel pam-devel zlib-devel autoconf automake libtool
    
  2. Clone source files and move to project directory

     git clone https://github.com/shellinabox/shellinabox.git && cd shellinabox
    
  3. Run autotools in project directory

     autoreconf -i
    
  4. Run configure and make in project directory

     ./configure && make
    

Debian package

For building and installing .deb packages you can use commands listed bellow. Note that dependencies from the first step above are also required.

  1. Build package

    dpkg-buildpackage -b
    
  2. Install package

    dpkg -i ../shellinabox_{ver}_{arch}.deb
    

For more information about .deb packages please see INSTALL.Debian file.

Issues

All reported issues were imported from Google Code Project Issues. You can report new issues here, but first please try to reproduce them with package created from our sources.