andersk / test.git / blame
| Commit | Line | Data |
|---|---|---|
| 8e34c313 MG |
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 | |
| e0fd2d13 | 32 | files that are managed by the system tools. This allows it to install |
| 8e34c313 MG |
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 | |
| e0fd2d13 | 43 | both the private key and the public certificate in PEM (i.e. ASCII) format. |
| 8e34c313 MG |
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. |