From 8e8b719126c2602780ee49fc684a5e095f3926f6 Mon Sep 17 00:00:00 2001
From: mo khan <mo@mokhan.ca>
Date: Wed, 5 Mar 2025 13:06:06 -0700
Subject: docs: update the README

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 0217ebce..43fc3fe3 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,27 @@ Below is a recording of a SAML based service provider initiated login, displayin
 
 ![SAML Login](./screencast.webm)
 
+## Getting Started
+
+1. Install tools:
+  ```sh
+  $ mise install
+  ```
+1. Add entries to `/etc/hosts`:
+  ```sh
+  $ tail -n3 /etc/hosts
+  127.0.0.1 api.example.com
+  127.0.0.1 idp.example.com
+  127.0.0.1 ui.example.com
+  ```
+1. Start servers:
+  ```sh
+  $ mage
+  ```
+1. Open browser to `http://ui.example.com:8080/saml/new` to start a new SAML
+   session. Or open `http://ui.example.com:8080/oidc/new` to start a new OIDC
+   session.
+
 ## Experiments
 
 ### Twirp + gRPC (AuthZ)
-- 
cgit v1.2.3