From 95366e461703046eab0661d3c1dbd095ae5c444f Mon Sep 17 00:00:00 2001
From: Cory Zue <cory@coryzue.com>
Date: Tue, 11 Jun 2024 14:16:24 +0200
Subject: [PATCH] cookbook for changing site domain

---
 deployment/kamal.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/deployment/kamal.md b/deployment/kamal.md
index 086038d..6269c3b 100644
--- a/deployment/kamal.md
+++ b/deployment/kamal.md
@@ -473,3 +473,17 @@ ALLOWED_HOSTS = [
 
 It is recommended to read [the security documentation](https://docs.djangoproject.com/en/5.0/topics/security/#host-headers-virtual-hosting)
 for this feature to understand the implications of it being included.
+
+### Cookbooks
+
+#### Changing your site URL
+
+To change your site's URL, do the following:
+
+1. Set up a new DNS endpoint as outlined above.
+2. Change all ``Host(`example.com`)`` values in your traefik configuration in `deploy.yml` to the new domain.
+3. Update your `ALLOWED_HOSTS` setting / environment variable as needed.
+4. Run `kamal traefik reboot`.
+4. Run `kamal deploy`
+
+Your app should now be running on your new domain.