ngircd.README.Debian 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. What's new in ngIRCd 18
  2. =======================
  3. Generic
  4. -------
  5. For generic information, including the new names of configuration
  6. variables, see /usr/share/doc/ngircd/INSTALL.gz
  7. TLS support
  8. ===========
  9. Some things to take into account when configuring TLS/SSL support:
  10. * The irc user must be able to read the key file.
  11. * ngIRCd will run without a DH parameters file but that's a bad idea.
  12. * A certificate exchange requires restart.
  13. Certificate location
  14. --------------------
  15. * If your certificate and key are for ngIRCd only: Simply place them in
  16. /etc/ngircd, set KeyFile and CertFile accordingly. To secure the key
  17. file (server.key):
  18. chown irc:irc server.key
  19. chmod 600 server.key
  20. * If however you offer several TLS-based services that using the same
  21. certificate and key: Consider installing the ssl-cert package which
  22. provides the ssl-cert group. Place the certificate file (server.crt)
  23. in /etc/ssl/certs/ and the key file (server.key) in /etc/ssl/private/,
  24. and make sure ngIRCd can read it:
  25. chown root:ssl-cert /etc/ssl/private/server.key
  26. chmod 640 /etc/ssl/private/server.key
  27. adduser irc ssl-cert
  28. Repeat the last step for all users that run a daemon providing TLS.
  29. DH parameters file
  30. ------------------
  31. It is suggested to create a DH params file. If missing, ngIRCd will
  32. create one on the fly but this will prolong each startup.
  33. To create that file:
  34. * using gnutls (from gnutls-cli package):
  35. certtool --generate-dh-params --bits 2048 >/etc/ngircd/dhparams.pem
  36. * using openssl:
  37. openssl dhparam -2 -out /etc/ngircd/dhparams.pem 2048
  38. This has to be done only once. Don't forget to enable the DHFile
  39. setting in /etc/ngircd/ngircd.conf.
  40. Certificate exchange
  41. --------------------
  42. Due to limitations of GnuTLS, a re-start of ngIRCd is required if the
  43. certificates were changed. A reload is not sufficient.