"Fossies" - the Fresh Open Source Software Archive

Member "shellinabox-2.20/INSTALL.Debian" (9 Nov 2016, 2224 Bytes) of package /linux/privat/shellinabox-2.20.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "INSTALL.Debian": 2.19_vs_2.20.

    1 You can build package files for Debian based distributions (including Ubuntu)
    2 by running the standard build commands:
    3 
    4   # Install build dependencies
    5   i="$(dpkg-checkbuilddeps 2>&1 | sed -e 's/.*dependencies: //;t;d')"
    6   [ -n "$i" ] && sudo apt-get install $i
    7 
    8   # Build package files
    9   dpkg-buildpackage
   10 
   11 These commands replace "./configure" and "make", which you would run on
   12 non-Debian systems.
   13 
   14 If you have a very old Debian system, you might have to use "fakeroot
   15 dpkg-buildpackage", instead of just "dpkg-buildpackage".
   16 
   17 If you want HTTPS support, and if you want the ability to run "shellinaboxd"
   18 as a non-privileged user, you should now install these run-time libraries:
   19 
   20   sudo apt-get install libssl0.9.8 libpam0g openssl
   21 
   22 Running "dpkg-buildpackage" puts package files into your parent directory.
   23 You can install them with:
   24 
   25   sudo dpkg -i ../shellinabox_*.deb
   26 
   27 You can now connect to your new shell at:
   28 
   29   http://localhost:4200
   30 
   31 In contrast to installation by "make install", this package file creates
   32 files that are managed by the system tools. This allows it to install
   33 configuration files in "/etc" and to automatically start the daemon.
   34 
   35 You can configure the daemon process by editing "/etc/default/shellinabox".
   36 
   37 You can also provide SSL certificates for your site by installing them in
   38 "/var/lib/shellinabox". By default, the system will install self-signed
   39 certificates for you. These certificates are likely to raise warnings when
   40 you point your browser to the site.
   41 
   42 At the very least, you need a file called "certificate.pem" that includes
   43 both the private key and the public certificate in PEM (i.e. ASCII) format.
   44 Additionally, you should create files for each of the publicly visible
   45 hostnames that your machine has. These are named "certificate-${FQDN}.pem".
   46 You probably also want "certificate-localhost.pem".
   47 
   48 After you make any configuration changes, you need to restart the daemon by
   49 running:
   50 
   51   sudo /etc/init.d/shellinabox restart
   52 
   53 If you want to know which files were installed by the package, run
   54 
   55   dpkg -L shellinabox
   56 
   57 If you want to uninstall it again, run:
   58 
   59   sudo apt-get remove shellinabox
   60 
   61 For all other administrative tasks, refer to the documentation that came
   62 with your system.