Project

General

Profile

Download (2.17 KB) Statistics
| Branch: | Revision:
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.
(6-6/56)