Git Product home page Git Product logo

shellinabox's Introduction

shellinabox

Build Status Join the chat at https://gitter.im/shellinabox/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.

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. 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.

shellinabox's People

Contributors

a-detiste avatar andersk avatar benjiwiebe avatar blakemcbride avatar claneys avatar danielg avatar druzus avatar easybe avatar gitter-badger avatar grimthorr avatar jayschwa avatar jgrennison avatar kluka avatar mvanholsteijn avatar rkd77 avatar smarter avatar sroeder avatar thubo avatar tickelton avatar tomtor avatar triska avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.