Skip to content

macOS 15

macOS Setup Guide

VSCode

For macOS it is recommended to fetch and install VSCode from the VSCode home page.

You also need to have the code CLI available. To do this, open VSCode, go to the Command Palette (Cmd+Shift+P), and type Shell Command: Install 'code' command in PATH. This will allow you to run code from the terminal.

To check:

code --version

It should return something like the output below:

1.100.2
848b80aeb52026648a8ff9f7c45a9b0a80641e2e
arm64

Setup Docker on macOS

We recommend using the official Docker Desktop application. See docker website for setup tools.

⭐️ Note: If you are using an arm based Mac (M1, M2, M3 etc.), you will need to ensure that you download the version of Docker Desktop that is compatible with Apple Silicon.

At the end of the installation, you should have a working Docker Desktop application. You can verify this by running:

docker --version

Homebrew

Make sure you have Homebrew installed. If not, you can install it by running:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Follow the on-screen instructions. After installation, you may need to add Homebrew to your shell profile (.zprofile, .zshrc, etc.).

✅ jq

jq is a command-line JSON processor.

brew install jq

Verify:

jq --version

✅ make

Make is a build automation tool that is used to manage dependencies and automate the build process.

brew install make

Git

brew install git

If you want to share changes upstream to GeoSight-OS, you should sign your commits. See the GitHub Documentation on this topic to see how to prepare your system for this.

Next Steps

🪧 Now that you have the docker, move on to the generic workflow, starting with Cloning.