From 31b0b6a18779c9e992a66794f9a6416f1187f745 Mon Sep 17 00:00:00 2001
From: rzmk <30333942+rzmk@users.noreply.github.com>
Date: Mon, 11 Aug 2025 11:49:46 -0400
Subject: [PATCH] feat: mention ahoy Permission denied error and macOS postgis
 fix

postgis fix as per #29.
---
 docs/onboarding/ckan-setup.mdx | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/onboarding/ckan-setup.mdx b/docs/onboarding/ckan-setup.mdx
index 9c9d950..2bf05bb 100644
--- a/docs/onboarding/ckan-setup.mdx
+++ b/docs/onboarding/ckan-setup.mdx
@@ -112,17 +112,30 @@ git config --global credential.credentialStore "cache"
 ```
 -->
 
-## Set up ckan-compose
+## Set up ckan-compose (provides you with PostgreSQL, Redis, and SOLR 9)
 
 ```bash
 cd ~/
 sudo apt install docker-compose -y
 git clone https://github.com/tino097/ckan-compose.git
 cd ckan-compose
+git switch solr-9-impl
 ahoy generate-env
 ahoy up
 ```
 
+:::info Apple Silicon?
+
+If you're using macOS, you may need to change the postgis image used in `ckan-compose/postgres/Dockerfile`. Change `FROM postgis/postgis:16-3.4-alpine` to FROM `imresamu/postgis:16-3.4-bundle0-bookworm` (based on [this issue](https://github.com/dathere/de-intern-guide/issues/29)).
+
+:::
+
+:::info Permission denied?
+
+If you get a "Permission denied" error, you may need to run `sudo ahoy up` instead of `ahoy up`.
+
+:::
+
 You may get asked after `ahoy generate-env` to provide a `PROJECT_NAME`, this can be anything so we'll put `myproject`. You may also use the defaults for `DATASTORE_READONLY_PASSWORD` and `POSTGRES_PASSWORD` for development.
 
 ## CKAN steps 1-4 with caveats