INSTALL.Debian

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