README.Debian
1 Dropbear for Debian
2 -------------------
3
4 This package will attempt to listen on port 22. If the OpenSSH
5 package ("ssh") is installed, the file /etc/default/dropbear
6 will be set up so that the server does not start by default.
7
8 You can run Dropbear concurrently with OpenSSH 'sshd' by
9 modifying /etc/default/dropbear so that "NO_START" is set to
10 "0" and changing the port number that Dropbear runs on. Follow
11 the instructions in the file.
12
13 This package suggests you install the "ssh" package. This package
14 provides the "ssh" client program, as well as the "/usr/bin/scp"
15 binary you will need to be able to retrieve files from a server
16 running Dropbear via SCP.
17
18 Replacing OpenSSH "sshd" with Dropbear
19 --------------------------------------
20
21 You will still want to have the "ssh" package installed, as it
22 provides the "ssh" and "scp" binaries. When you install this
23 package, it checks for existing OpenSSH host keys and if found,
24 converts them to the Dropbear format.
25
26 If this appears to have worked, you should be able to change over
27 by following these steps:
28
29 1. Stop the OpenSSH server
30 % /etc/init.d/ssh stop
31 2. Prevent the OpenSSH server from starting in the future
32 % touch /etc/ssh/sshd_not_to_be_run
33 3. Modify the Dropbear defaults file, set NO_START to 0 and
34 ensure DROPBEAR_PORT is set to 22.
35 % editor /etc/default/dropbear
36 4. Restart the Dropbear server.
37 % /etc/init.d/dropbear restart
38
39 See the Dropbear homepage for more information:
40 http://matt.ucc.asn.au/dropbear/dropbear.html
41
42
README.Debian.diet
1 Building with the diet libc
2 ---------------------------
3
4 This package optionally can be built with the diet libc instead of the
5 glibc to provide small statically linked programs. The resulting package
6 has no dependency on any other package.
7
8 To use the diet libc, make sure the latest versions of the dietlibc-dev
9 package is installed, and set DEB_BUILD_OPTIONS=diet in the environment
10 when building the package, e.g.:
11
12 # apt-get install dietlibc-dev
13 $ DEB_BUILD_OPTIONS=diet fakeroot apt-get source -b dropbear
14
15 -- Gerrit Pape <pape (a] smarden.org>, Sat, 17 Jul 2004 19:09:34 +0000
16
README.runit
1 Using the dropbear SSH server with runit's services supervision
2 ---------------------------------------------------------------
3
4 The dropbear SSH server is perfectly suited to be run under runit's
5 service supervision, and this package already has prepared an adequate
6 service directory. Follow these steps to enable the dropbear service
7 using the runit package.
8
9 If not yet installed on your system, install the runit package, and make
10 sure its service supervision is enabled (it's by default)
11
12 # apt-get install runit
13
14 Make sure the dropbear service normally handled through the sysv init
15 script is stopped
16
17 # /etc/init.d/dropbear stop
18
19 Create the system user ``dropbearlog'' which will run the logger service,
20 and own the logs
21
22 # adduser --system --home /var/log/dropbear --no-create-home dropbearlog
23
24 Create the log directory and make the newly created system user the owner
25 of this directory
26
27 # mkdir -p /var/log/dropbear && chown dropbearlog /var/log/dropbear
28
29 Optionally adjust the configuration of the dropbear service by editing the
30 run script
31
32 # vi /etc/dropbear/run
33
34 Finally enable the service by linking dropbear's service directory to
35 /var/service/. The service will be started within five seconds, and
36 automatically at boot time. The sysv init script is disabled; see the
37 runsvctrl(8) program for information on how to control services handled by
38 runit. See the svlogd(8) program on how to configure the log service.
39
40 # ln -s /etc/dropbear /var/service/
41
42 Optionally check the status of the service a few seconds later
43
44 # runsvstat -l /var/service/dropbear
45
46 -- Gerrit Pape <pape (a] smarden.org>, Sun, 16 May 2004 15:52:34 +0000
47