Official-ish Fork of Shell In A Box
Clone or download
Latest commit b7a8072 Sep 9, 2018
Failed to load latest commit information.
contrib Cleanup of debian control file before 2.11. Apr 1, 2012
debian New release with bug fixes. Nov 9, 2016
demo Improving cleanliness. Jul 24, 2015
libhttp Issue #384: compatibility with OpenSSL 1.1.0 Oct 8, 2016
logging Issue #381: Fixed segfaults at logging Jun 6, 2016
m4 Added empty m4 directory for autotools Apr 27, 2015
misc Adding selinux policy. TODO: Unconfined context misuse needed to fix Jan 17, 2017
shellinabox Issue #361: enable builds with MUSL libc Oct 11, 2016
.gitignore Added config.cache to gitignore Sep 1, 2015
AUTHORS First public release of the version 2.0 rewrite. This is the Dec 29, 2008 Update Mar 11, 2015
COPYING Started working on support for WebSockets. Mar 29, 2010
ChangeLog clean up debian/rules May 15, 2015
GPL-2 First public release of the version 2.0 rewrite. This is the Dec 29, 2008
INSTALL.Debian typos Mar 9, 2016 Added shellinaboxd.pdf make target May 24, 2016
NEWS First public release of the version 2.0 rewrite. This is the Dec 29, 2008
README First public release of the version 2.0 rewrite. This is the Dec 29, 2008
README.Fedora Remove trailing whitespace Mar 11, 2015 Update Sep 9, 2018
TODO Remove trailing whitespace Mar 11, 2015
commit VCS_VERSION: remove Subversion support, add support for Git & tarball May 14, 2015 Issue #361: enable builds with MUSL libc Oct 11, 2016
etc-pam.d-shellinabox-example Added some documentation explaining how to configure ShellInABox on F… Nov 23, 2009 Avoid closing the certificate file twice. Tweak … Mar 29, 2009 Fixed a potential assertion failure in the daemon, if a user manages … Aug 13, 2009


Build Status Join the chat at

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

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.

Shell In A Box preview

More information:


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


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

     git clone && 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.


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

  • The openssl package is required for HTTP/SSL support. Shell-in-a-box may be used without SSL such that the login session is not encrypted. To enable automatic creation of self-signed certificates or to use a generated certificate, install openssl.

  • On Debian Jessie, the default openssl package does not include the utilities necessary for Shell-in-a-box to generate self-signed certificates. Upgrade openssl to install a version of the tools that support certificate creation.