From bfd79c5270563b1af3ac90fe0d5bd47e0dcd5d8b Mon Sep 17 00:00:00 2001
From: ayntk-ai <122374094+ayntk-ai@users.noreply.github.com>
Date: Wed, 7 Aug 2024 21:11:23 +0200
Subject: [PATCH] updated contributing docs

---
 CONTRIBUTION.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTION.md b/CONTRIBUTION.md
index 02a21573c..42ba47ffd 100644
--- a/CONTRIBUTION.md
+++ b/CONTRIBUTION.md
@@ -11,24 +11,29 @@ You can ask for guidance anytime on our
 ### 1) Setup your development environment
 
 - You need to have Docker Engine (or equivalent) [installed](https://docs.docker.com/engine/install/) on your system.
-- For better DX, install [Spin](https://serversideup.net/open-source/spin/).
+- If you are using a Mac, I highly recommend installing [Orbsatck](https://orbstack.dev/download) as a much faster alternative and complete replacement to Docker Desktop.
+- For better DX, install [Spin](https://serversideup.net/open-source/spin/docs).
 
 ### 2) Set your environment variables
 
 - Copy [.env.development.example](./.env.development.example) to .env.
+- Make sure to set the DB_HOST environment variable to the Postgres container IP or, if using Orbstack, use the container name (e.g., postgres.coolify.orb.local) to make sure that the DB Migrations work.
 
 ## 3) Start & setup Coolify
 
 - Run `spin up` - You can notice that errors will be thrown. Don't worry.
   - If you see weird permission errors, especially on Mac, run `sudo spin up` instead. 
 
-### 4) Start development
+## 4) Install php to make sure you can do DB migrations (optional)
+
+### 5) Start development
 You can login your Coolify instance at `localhost:8000` with `test@example.com` and `password`.
 
 Your horizon (Laravel scheduler): `localhost:8000/horizon` - Only reachable if you logged in with root user.
 
 Mails are caught by Mailpit: `localhost:8025`
 
+
 ## New Service Contribution
 Check out the docs [here](https://coolify.io/docs/knowledge-base/add-a-service).