From 55cf18b689ad084611a8c14e48a1a02b5dd4e166 Mon Sep 17 00:00:00 2001
From: forsamori <forsamori@yahoo.co.uk>
Date: Tue, 18 Jul 2023 08:02:45 +0100
Subject: [PATCH] Add MacOS M1/2 setup steps to README (#25682)

Co-authored-by: Sam BC <samuel.balbirnie-cumming@xdesign.com>
---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index fd55c0073..52ba7988d 100644
--- a/README.md
+++ b/README.md
@@ -82,6 +82,18 @@ A **Vagrant** configuration is included for development purposes. To use it, com
 - Run `vagrant ssh -c "cd /vagrant && foreman start"`
 - Open `http://mastodon.local` in your browser
 
+To set up **MacOS** for native development, complete the following steps:
+
+- Install the latest stable Ruby version (use a ruby version manager for easy installation and management of ruby versions)
+- Run `brew install postgresql@14`
+- Run `brew install redis`
+- Run `brew install imagemagick`
+- Install Foreman or a similar tool (such as [overmind](https://github.com/DarthSim/overmind)) to handle multiple process launching.
+- Navigate to Mastodon's root directory and run `brew install nvm` then `nvm use` to use the version from .nvmrc
+- Run `corepack enable && yarn set version classic`
+- Run `bundle exec rails db:setup` (optionally prepend `RAILS_ENV=development` to target the dev environment)
+- Finally, run `overmind start -f Procfile.dev`
+
 ### Getting Started with GitHub Codespaces
 
 To get started, create a codespace for this repository by clicking this 👇