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:
It should return something like the output below:
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:
Homebrew¶
Make sure you have Homebrew installed. If not, you can install it by running:
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.
Verify:
✅ make¶
Make is a build automation tool that is used to manage dependencies and automate the build process.
Git¶
brew install git
Recommended¶
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.