docs: add installation instructions

docs/installation/README.md

@@ -1 +1,5 @@
 # Installing Loki
+
+1. [Installing using Ksonnet (recommended)](./ksonnet.md)
+2. [Installing through Helm](./helm.md)
+3. [Installing locally](./local.md)

docs/installation/helm.md

@@ -1 +1,108 @@
 # Installing Loki with Helm
+
+## Prerequisites
+
+Make sure you have Helm [installed](https://helm.sh/docs/using_helm/#installing-helm) and
+[deployed](https://helm.sh/docs/using_helm/#installing-tiller) to your cluster. Then add
+Loki's chart repository to Helm:
+
+```bash
+$ helm repo add loki https://grafana.github.io/loki/charts
+```
+
+You can update the chart repository by running:
+
+```bash
+$ helm repo update
+```
+
+## Deploy Loki to your cluster
+
+### Deploy with default config
+
+```bash
+$ helm upgrade --install loki loki/loki-stack
+```
+
+### Deploy in a custom namespace
+
+```bash
+$ helm upgrade --install loki --namespace=loki loki/loki
+```
+
+### Deploy with custom config
+
+```bash
+$ helm upgrade --install loki loki/loki --set "key1=val1,key2=val2,..."
+```
+
+### Deploy Loki Stack (Loki, Promtail, Grafana, Prometheus)
+
+```bash
+$ helm upgrade --install loki loki/loki-stack
+```
+
+## Deploy Grafana to your cluster
+
+To install Grafana on your cluster with Helm, use the following command:
+
+```bash
+$ helm install stable/grafana -n loki-grafana
+```
+
+To get the admin password for the Grafana pod, run the following command:
+
+```bash
+$ kubectl get secret --namespace <YOUR-NAMESPACE> loki-grafana -o jsonpath="{.data.admin-password}" | base64 --decode ; echo
+```
+
+To access the Grafana UI, run the following command:
+
+```bash
+$ kubectl port-forward --namespace <YOUR-NAMESPACE> service/loki-grafana 3000:80
+```
+
+Navigate to `http://localhost:3000` and login with `admin` and the password
+output above. Then follow the [instructions for adding the Loki Data Source](../getting-started/grafana.md), using the URL
+`http://loki:3100/` for Loki.
+
+## Run Loki behind HTTPS ingress
+
+If Loki and Promtail are deployed on different clusters you can add an Ingress
+in front of Loki. By adding a certificate you create an HTTPS endpoint. For
+extra security you can also enable Basic Authentication on the Ingress.
+
+In promtail, set the following values to communicate using HTTPS and basic
+authentication:
+
+```yaml
+loki:
+  serviceScheme: https
+  user: user
+  password: pass
+```
+
+Sample Helm template for Ingress:
+
+```yaml
+apiVersion: extensions/v1beta1
+kind: Ingress
+metadata:
+annotations:
+    kubernetes.io/ingress.class: {{ .Values.ingress.class }}
+    ingress.kubernetes.io/auth-type: "basic"
+    ingress.kubernetes.io/auth-secret: {{ .Values.ingress.basic.secret }}
+name: loki
+spec:
+rules:
+- host: {{ .Values.ingress.host }}
+    http:
+    paths:
+    - backend:
+        serviceName: loki
+        servicePort: 3100
+tls:
+- secretName: {{ .Values.ingress.cert }}
+    hosts:
+    - {{ .Values.ingress.host }}
+```

docs/installation/ksonnet.md

@@ -1 +1,67 @@
 # Installing Loki with Ksonnet
+
+## Prerequisites
+
+Make sure you have Ksonnet v0.8.0:
+
+```
+$ brew install https://raw.githubusercontent.com/ksonnet/homebrew-tap/82ef24cb7b454d1857db40e38671426c18cd8820/ks.rb
+$ brew pin ks
+$ ks version
+ksonnet version: v0.8.0
+jsonnet version: v0.9.5
+client-go version: v1.6.8-beta.0+$Format:%h$
+```
+
+In your config repo, if you don't have a ksonnet application, make a new one
+(copies the credentials from your current kubectl context):
+
+```
+$ ks init <application name>
+$ cd <application name>
+$ ks env add loki --namespace=loki
+```
+
+## Deploying
+
+Grab the Loki module using jb:
+
+```bash
+$ go get -u github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb
+$ jb init
+$ jb install github.com/grafana/loki/production/ksonnet/loki
+```
+
+Be sure to replace the username, password and the relevant htpasswd contents.
+Making sure to set the value for username, password, and htpasswd properly,
+replace the contents of `environments/loki/main.jsonnet` with:
+
+```jsonnet
+local gateway = import 'loki/gateway.libsonnet';
+local loki = import 'loki/loki.libsonnet';
+local promtail = import 'promtail/promtail.libsonnet';
+
+loki + promtail + gateway {
+  _config+:: {
+    namespace: 'loki',
+    htpasswd_contents: 'loki:$apr1$H4yGiGNg$ssl5/NymaGFRUvxIV1Nyr.',
+
+    promtail_config: {
+      scheme: 'http',
+      hostname: 'gateway.%(namespace)s.svc' % $._config,
+      username: 'loki',
+      password: 'password',
+      container_root_path: '/var/lib/docker',
+    },
+
+    replication_factor: 3,
+    consul_replicas: 1,
+  },
+}
+```
+
+Notice that `container_root_path` is your own data root for the Docker Daemon,
+run `docker info | grep "Root Dir"` to get it.
+
+Run `ks show loki` to see the manifests that will be deployed to the cluster and
+finally run `ks apply loki` to deploy it.

docs/installation/local.md

@@ -1 +1,42 @@
 # Installing Loki Locally
+
+## Release Binaries
+
+Every [Loki release](https://github.com/grafana/loki/releases) includes
+prebuilt binaries:
+
+```bash
+# download a binary (modify app, os, and arch as needed)
+# Installs v0.3.0. Go to the releases page for the latest version
+$ curl -fSL -o "/usr/local/bin/loki.gz" "https://github.com/grafana/loki/releases/download/v0.3.0/loki_linux_amd64.gz"
+$ gunzip "/usr/local/bin/loki.gz"
+
+# make sure it is executable
+$ chmod a+x "/usr/local/bin/loki"
+```
+
+## Manual Build
+
+### Prerequisites
+
+- Go 1.11 or later
+- Make
+- Docker (for updating protobuf files and yacc files)
+
+### Building
+
+Clone Loki to `$GOPATH/src/github.com/grafana/loki`:
+
+```bash
+$ git clone https://github.com/grafana/loki $(go env GOPATH)/src/github.com/grafana/loki
+```
+
+Then change into that directory and run `make loki`:
+
+```bash
+$ cd $(go env GOPATH)/src/github.com/grafana/loki
+$ make loki
+
+# A file at ./cmd/loki/loki will be created and is the
+# final built binary.
+```