INSTALL

   1 1. Prerequisites
   2 ----------------
   3
   4 You will need working installations of Zlib and OpenSSL.
   5
   6 Zlib:
   7 http://www.cdrom.com/pub/infozip/zlib/
   8
   9 OpenSSL:
  10 http://www.openssl.org/
  11
  12 OpenSSH can utilise Pluggable Authentication Modules (PAM) if your system
  13 supports it. PAM is standard on Redhat and Debian Linux and on Solaris.
  14
  15 PAM:
  16 http://www.kernel.org/pub/linux/libs/pam/
  17
  18 If you wish to build the GNOME passphrase requestor, you will need the GNOME
  19 libraries and headers.
  20
  21 GNOME:
  22 http://www.gnome.org/
  23
  24 If you are planning to use OpenSSH on a Unix which lacks a Kernel random
  25 number generator (/dev/urandom), you will need to install the Entropy
  26 Gathering Daemon (or similar). You will also need to specify the
  27 --with-egd-pool option to ./configure.
  28
  29 EGD:
  30 http://www.lothar.com/tech/crypto/
  31
  32
  33 2. Building / Installation
  34 --------------------------
  35
  36 To install OpenSSH with default options:
  37
  38 ./configure
  39 make
  40 make install
  41
  42 This will install the OpenSSH binaries in /usr/local/bin, configuration files
  43 in /usr/local/etc, the server in /usr/local/sbin, etc. To specify a different
  44 installation prefix, use the --prefix option to configure:
  45
  46 ./configure --prefix=/opt
  47 make
  48 make install
  49
  50 Will install OpenSSH in /opt/{bin,etc,lib,sbin}. You can also override
  51 specific paths, for example:
  52
  53 ./configure --prefix=/opt --sysconfdir=/etc/ssh
  54 make
  55 make install
  56
  57 This will install the binaries in /opt/{bin,lib,sbin}, but will place the
  58 configuration files in /etc/ssh.
  59
  60 There are a few other options to the configure script:
  61
  62 --enable-gnome-askpass will build the GNOME passphrase dialog. You need a
  63 working installation of GNOME, including the development headers, for this
  64 to work.
  65
  66 --with-random=/some/file allows you to specify an alternate source of
  67 random numbers (the default is /dev/urandom). Unless you are absolutly
  68 sure of what you are doing, it is best to leave this alone.
  69
  70 --with-egd-pool=/some/file allows you to enable Entropy Gathering Daemon
  71 support and to specify a EGD pool socket. You will need to use this if your
  72 Unix does not support the /dev/urandom device (or similar).
  73
  74 --without-askpass will disable X11 password requestor support in ssh-add
  75
  76
  77 3. Configuration
  78 ----------------
  79
  80 The runtime configuration files are installed by in ${prefix}/etc or
  81 whatever you specified as your --sysconfdir (/usr/local/etc by default).
  82
  83 The default configuration should be instantly usable, though you should
  84 review it to ensure that it matches your security requirements.
  85
  86 For more information on configuration, please refer to the manual pages
  87 for sshd, ssh and ssh-agent.
  88