shellinabox

This is a fork of the project Shell In A Box. The fork was created because the original project was not maintained by the authorized author. He did provide some early support for the Debian package.

Our aim is to continue with maintenance of the shellinabox project. For a list of recent changes, please see CHANGELOG.md.

If you have any questions, issues, or patches, please feel free to submit a pull request or report an issue. You can also drop an email to the original project issue #261 discussion 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.

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.

Install dependencies

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

yum install git openssl-devel pam-devel zlib-devel autoconf automake libtool

Clone source files and move to project directory

 git clone https://github.com/shellinabox/shellinabox.git && cd shellinabox

Run autotools in project directory
```
 autoreconf -i
```
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.

Build package
```
dpkg-buildpackage -b
```

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. In new issue report please include following things:

Name and version of your operating system
Name and version of your browser
Version of shellinabox
Steps to reproduce the problem

Also feel free to post any questions or comments in shellinabox chat room on Gitter.

Known Issues