From 661ee9c2ae581a09be689f4756c6c81a80c22c56 Mon Sep 17 00:00:00 2001
From: Matthew Kent <matthew@37signals.com>
Date: Wed, 13 May 2026 13:34:05 -0700
Subject: [PATCH] Add our standard section on setting maintenance mode.

---
 saas/README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/saas/README.md b/saas/README.md
index bec3b279f..540c1aaae 100644
--- a/saas/README.md
+++ b/saas/README.md
@@ -89,6 +89,22 @@ Staging is primarily intended for testing infrastructure changes. It uses produc
 
 - https://app.fizzy-staging.com/
 
+## Maintenance mode
+
+To take production offline for maintenance, run `kamal-proxy stop` on the load balancers via `knife ssh`:
+
+```bash
+knife ssh 'hostname:fizzy-lb-*' "sudo docker exec fizzy-load-balancer kamal-proxy stop fizzy --message='Sorry! Fizzy is undergoing some maintenance and will be back shortly.'"
+```
+
+Verify maintenance is enabled by visiting https://app.fizzy.do/.
+
+To lift maintenance mode:
+
+```bash
+knife ssh 'hostname:fizzy-lb-*' 'sudo docker exec fizzy-load-balancer kamal-proxy resume fizzy'
+```
+
 ## License
 
 fizzy-saas is released under the [O'Saasy License](LICENSE.md).