First WIP version for installations

Author: lpgarzonr

docs/getting-started/installation.mdx

@@ -1,5 +1,57 @@
 ---
 sidebar_position: 1
 ---
+# Installation
 
-# Installation
+For this example we create a functioning local setup using kind.
+The end goal is to leverage Flux and Kustomize to manage the cluster.
+
+We will configure Flux to install, test and upgrade a demo app using
+`OCIRepository` and `HelmRelease` custom resources.
+Flux will monitor the Helm repository, and it will automatically
+upgrade the Helm releases to their latest chart version based on semver ranges.
+
+## Prerequisites
+
+- [Docker](https://www.docker.com) or [podman](https://podman.io): install either docker or podman in order to run the kind cluster
+- [Kind](https://kind.sigs.k8s.io/): In order to have a local kubernetes cluster you can use kind. Kind Installation: [Kind Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/)
+  On macOS using Homebrew:
+  ```sh
+  brew install kind
+  ```
+- [Helm](https://helm.sh/): In order to bootstrap flux, helm is required. Checkout various ways to install helm [here](https://helm.sh/docs/intro/install/)
+  On macOS using Homebrew:
+  ```sh
+  brew install helm
+  ```
+- Either specify your github.com username using the `GH_USER` environment variable OR install the gh cli using:
+```sh
+brew install gh
+```
+
+## Bootstrap local environment
+
+clone the repo https://github.com/openmfp/helm-charts
+
+The `scripts/start.sh` contains all steps needed to bootstrap the local environment. The script will automate the following steps:
+- Create kind cluster called `openmfp`
+- Install flux
+- Prepare secrets
+
+```sh
+## [Secrets]: configure the following environment variables:
+export KEYCLOAK_SECRET='' # client secret for the 'openmfp' keycloak client
+export GH_TOKEN='' # token used to pull the openmfp docker images
+```
+- apply flux deployment configuration
+
+To start the bootstrapping and local installation invoke
+```sh
+./local-setup/scripts/start.sh
+```
+
+Once the process is completed you can access the environment using http://localhost:8000
+
+# Optional Steps
+
+- Keycloak client secret: It is possible to set a custom keycloak client secret by setting the `KEYCLOAK_SECRET` environment variable before running the bootstrap script.