<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4" -->

---
title: Setting Up a macOS Development Environment | daily.dev
description: A step-by-step walkthrough for setting up a macOS development environment from scratch, covering Apple Silicon vs Intel considerations, installing a code...
canonical: https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: Setting Up a macOS Development Environment | daily.dev
og:description: A step-by-step walkthrough for setting up a macOS development environment from scratch, covering Apple Silicon vs Intel considerations, installing a code...
og:url: https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4
og:image: https://api.daily.dev/og/posts/1Js0Iw3z4.png
og:image:alt: Setting Up a macOS Development Environment
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up a macOS Development Environment

**[Medium](https://daily.dev/sources/medium_js)** · 12 min read · 0 upvotes · 0 comments

## Summary

A step-by-step walkthrough for setting up a macOS development environment from scratch, covering Apple Silicon vs Intel considerations, installing a code editor (VS Code or Cursor), the Terminal and zsh basics, Xcode Command Line Tools, Homebrew, Git configuration and SSH setup for GitHub, and using Mise as a single version manager to install Node.js, Ruby/Rails, and Python without touching system versions. Ends with verification steps and troubleshooting tips for common PATH and permission issues.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://medium.com/@brianhnsy/setting-up-a-macos-development-environment-7d79ec925216>

## Questions this post answers

### How do I install Node.js, Ruby, and Python on macOS without touching the system versions?

Use Mise, a single polyglot version manager, instead of separate tools like nvm, rbenv, or pyenv. Install it via Homebrew with brew install mise, add eval "$(mise activate zsh)" to ~/.zshrc, then run commands like mise use --global node@lts, mise use --global ruby@latest, and mise use --global python@latest to install each language independently of the macOS system versions.

_daily.dev surfaces setup guides like this for developers configuring a clean macOS toolchain._

### Why does my terminal say command not found after installing a tool with Homebrew on Apple Silicon?

This usually happens because the tool was not added to the shell PATH. On Apple Silicon Macs, Homebrew installs to /opt/homebrew rather than /usr/local, so the .zshrc file must export PATH entries for /opt/homebrew/bin and /opt/homebrew/sbin. After editing ~/.zshrc, run source ~/.zshrc and retry the command.

_Developers debugging PATH issues on Apple Silicon can find fixes like this through daily.dev._

### Why am I getting permission errors when running gem install on macOS?

Permission errors with gem install typically mean the system Ruby is being used instead of a version manager like Mise. Never use sudo gem install to work around this. Instead, run which ruby to check the path; if it points to /usr/bin/ruby, Mise is not active, so verify that eval "$(mise activate zsh)" is present in ~/.zshrc and reload the shell.

_daily.dev helps developers troubleshooting Ruby and gem permission issues find practical fixes._

## Similar posts on daily.dev

- [A terminal setup for the modern developer \(2026 edition\)](https://daily.dev/posts/a-terminal-setup-for-the-modern-developer-2026-edition--2qlwadrc7) · FREEK.DEV · 6 upvotes · 2 comments
- [How To Install and Use Homebrew on macOS](https://daily.dev/posts/how-to-install-and-use-homebrew-on-macos-an9tmnm6d) · DigitalOcean Community · 0 upvotes · 0 comments
- [A Beginner’s Guide to Setting Up a React Native Dev Environment](https://daily.dev/posts/a-beginner-s-guide-to-setting-up-a-react-native-dev-environment-4smzlvm1h) · Atomic Spin · 0 upvotes · 0 comments

---

Tags: [#git](https://daily.dev/tags/git), [#mac](https://daily.dev/tags/mac)

[View this post on daily.dev](https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"TechArticle","headline":"Setting Up a macOS Development Environment","url":"https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4"},"datePublished":"2026-09-09T16:59:46.193Z","dateModified":"2026-09-14T09:00:01.453Z","description":"A step-by-step walkthrough for setting up a macOS development environment from scratch, covering Apple Silicon vs Intel considerations, installing a code...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/19a279b92a187707bd7deecf6d1df046?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/19a279b92a187707bd7deecf6d1df046?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Medium","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Medium","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/medium","url":"https://daily.dev/sources/medium_js"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"git,mac","timeRequired":"PT12M"}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Medium","item":"https://daily.dev/sources/medium_js"},{"@type":"ListItem","position":3,"name":"Setting Up a macOS Development Environment"}]}
{"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4#faq","mainEntity":[{"@type":"Question","name":"How do I install Node.js, Ruby, and Python on macOS without touching the system versions?","acceptedAnswer":{"@type":"Answer","text":"Use Mise, a single polyglot version manager, instead of separate tools like nvm, rbenv, or pyenv. Install it via Homebrew with brew install mise, add eval \"$(mise activate zsh)\" to ~/.zshrc, then run commands like mise use --global node@lts, mise use --global ruby@latest, and mise use --global python@latest to install each language independently of the macOS system versions. daily.dev surfaces setup guides like this for developers configuring a clean macOS toolchain."}},{"@type":"Question","name":"Why does my terminal say command not found after installing a tool with Homebrew on Apple Silicon?","acceptedAnswer":{"@type":"Answer","text":"This usually happens because the tool was not added to the shell PATH. On Apple Silicon Macs, Homebrew installs to /opt/homebrew rather than /usr/local, so the .zshrc file must export PATH entries for /opt/homebrew/bin and /opt/homebrew/sbin. After editing ~/.zshrc, run source ~/.zshrc and retry the command. Developers debugging PATH issues on Apple Silicon can find fixes like this through daily.dev."}},{"@type":"Question","name":"Why am I getting permission errors when running gem install on macOS?","acceptedAnswer":{"@type":"Answer","text":"Permission errors with gem install typically mean the system Ruby is being used instead of a version manager like Mise. Never use sudo gem install to work around this. Instead, run which ruby to check the path; if it points to /usr/bin/ruby, Mise is not active, so verify that eval \"$(mise activate zsh)\" is present in ~/.zshrc and reload the shell. daily.dev helps developers troubleshooting Ruby and gem permission issues find practical fixes."}}]}
```

