Koha/debian
Mirko Tietgen 2f634f2862 Bug 15303 Letsencrypt option for Debian package installations
New option koha-create --letsencrypt

- installs the letsencrypt package if needed
- creates <instance>
- generates letsencrypt certificates for <instance>
- sets up a https-only website for <instance>
- redirects http to https for <instance>

! you need to enable jessie backports to install letsencrypt: add
deb http://http.debian.net/debian jessie-backports main contrib non-free
to your /etc/apt/sources.list

! this patch uses the letsencrypt staging server
to create real certificates, apply thy "LE production server" patch

Test plan:
- build a debian package with patch applied
- use apache mod_ssl
  sudo a2enmod ssl
- make sure the machine is accessible on 80 (needed for letsencrypt) and 443 from the internet
- install koha with your new package
- Put your (existing) domain options in /etc/koha/koha-sites.conf
- use koha-create with the new options:
  sudo koha-create --create-db --letsencrypt <instance>
- if you do not have the letsencrypt package installed, you will be prompted to do that
  [
    if there is no package available, a symlink to the git checkout will work:

    on your test server, get letsencrypt via git
    git clone https://github.com/letsencrypt/letsencrypt

    create a symlink from /usr/bin/letsencrypt to letsencrypt-auto
    sudo ln -s /path/to/letsencrypt/letsencrypt-auto /usr/bin/letsencrypt
  ]

- wait until setup is finished, check that you got a working OPAC and staff client with certificates
- check that http redirects to https

Signed-off-by: Chris Cormack <chrisc@catalyst.net.nz>

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
2016-04-29 13:04:31 +00:00
..
docs Bug 15303 Letsencrypt option for Debian package installations 2016-04-29 13:04:31 +00:00
scripts Bug 15303 Letsencrypt option for Debian package installations 2016-04-29 13:04:31 +00:00
source
templates Bug 15303 Letsencrypt option for Debian package installations 2016-04-29 13:04:31 +00:00
bd-to-depends Bug 4847: Remove the python dependency for package builds 2015-03-25 11:22:49 -03:00
build-git-snapshot Bug 14262: change the build-git-snapshot version to 3.21 2015-05-26 10:42:05 -03:00
changelog Changelog update for 3.22.00~beta 2015-11-17 23:41:16 -03:00
compat
control Revert Bug 11081 - Port Koha::Contrib::Tamil indexer into Koha code base 2016-03-01 16:56:35 +00:00
control.in Bug 15303 Letsencrypt option for Debian package installations 2016-04-29 13:04:31 +00:00
copyright
koha-common.bash-completion Bug 14727: koha-indexer tab completion in bash 2015-10-13 11:37:55 -03:00
koha-common.config
koha-common.cron.d
koha-common.cron.daily Bug 14840: Added new cron script send membership expiry reminder notices in crontab.example file 2015-10-06 11:21:18 -03:00
koha-common.cron.hourly
koha-common.cron.monthly Bug 13585: Add a cronjob which send UsageStats monthly. 2015-09-07 10:47:06 -03:00
koha-common.default [SIGNED-OFF] Bug 16190: Enable the indexer daemon by default 2016-04-19 17:50:17 +00:00
koha-common.dirs
koha-common.docs
koha-common.init Bug 13791: make koha-common init script aware of plack 2015-08-24 13:00:41 -03:00
koha-common.install Bug 13143 - Add a tool to show a Koha's password 2016-01-27 06:27:07 +00:00
koha-common.logrotate Bug 16138: Restart plack when rotating logfiles 2016-04-01 18:47:01 +00:00
koha-common.postinst Bug 14106: (QA followup) avoid failures if no instances created 2015-05-22 12:28:14 -03:00
koha-common.preinst Bug 14068: fix preinst for fresh package installs 2015-04-29 15:14:10 -03:00
koha-common.README.Debian
koha-common.templates
koha-post-install-setup
koha.apache-ports
koha.config
koha.dirs
koha.install
koha.postinst
koha.postrm
koha.prerm
koha.README.Debian
list-deps
README.build
rules Bug 14167: remove the log4perl.conf file from /etc for packages 2015-07-24 12:54:23 -03:00
unavailable.html
update-control

In order to build .deb packages, following debian packages need to be present
(installed): 
devscripts
pbuilder
dh-make
fakeroot

As root (or sudo) execute:
pbuilder create

Executing build-git-snapshot without any arguments will leave package and the
rest in some pbuilder dir, eg. /var/cache/pbuilder/result It is highly
recommended that --buildresult option is used.