From e814cc0cbbb0a462833fb2ca25b6c153d092798d Mon Sep 17 00:00:00 2001
From: Ian Bashford <ian@bashford.net>
Date: Mon, 1 Apr 2019 22:05:42 +0100
Subject: [PATCH] Added example page for alpine linux

---
 Installation-on-Alpine-Linux.md | 49 +++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 Installation-on-Alpine-Linux.md

diff --git a/Installation-on-Alpine-Linux.md b/Installation-on-Alpine-Linux.md
new file mode 100644
index 0000000..24e4011
--- /dev/null
+++ b/Installation-on-Alpine-Linux.md
@@ -0,0 +1,49 @@
+# Installation on Alpine Linux
+
+## Enabling the Community Repository
+dnscrypt-proxy is in the 'community' repository which needs to be enabled in `/etc/apk/respositories` by removing the comment `#` on the appropriate line e.g. 
+```
+# main and community enabled, testing disabled on the 'edge' branch
+http://alpine.mirror.wearetriple.com/edge/main
+http://alpine.mirror.wearetriple.com/edge/community
+#http://alpine.mirror.wearetriple.com/edge/testing
+```
+If you're not running on 'edge' then you might see the version numbers instead
+```
+# main and community enabled, testing disabled on the 'V3.9' branch
+http://alpine.mirror.wearetriple.com/V3.9/main
+http://alpine.mirror.wearetriple.com/V3.9/community
+#http://alpine.mirror.wearetriple.com/V3.9/testing
+```
+
+## Installation
+Alpine maintains discreet packages for dnscrypt-proxy, and the openrc package for managing the service
+```sh
+apk update && apk add dnscrypt-proxy dnscrypt-proxy-openrc
+```
+
+## Service Setup
+To start at boot, use
+```sh
+rc-update add dnscrypt-proxy default
+```
+Then to start the service immediately...
+```sh
+rc-service dnscrypt-proxy start
+```
+or
+```sh
+/etc/init.d/dnscrypt-proxy start
+```
+## Files
+Configuration of the `/etc/dnscrypt-proxy/dnscrypt-proxy.toml` file is discussed elsewhere on this wiki.
+There are also some examples on [https://wiki.alpinelinux.org/wiki/DNSCrypt-Proxy](https://wiki.alpinelinux.org/wiki/DNSCrypt-Proxy). 
+
+Example configuration files are stored in `/usr/share/dnscrypt-proxy`.
+
+## Upgrades
+When upgrading the package, a new file `/etc/dnscrypt-proxy/dnscrypt-proxy.toml.apk-new` will be created.  The original configuration file remains, and the new default configuration file gets this `apk-new` extension.  Be aware that new configuration properties (if available) will have their default values in that file only, and can't be moved into the original.  To see the differences, use `diff`
+```sh
+diff /etc/dnscrypt-proxy/dnscrypt-proxy.toml /etc/dnscrypt-proxy/dnscrypt-proxy.toml.apk-new
+```
+