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