Skip to content

Commit

Permalink
Add instructions for Mac Apple Silicon on Developers section
Browse files Browse the repository at this point in the history
  • Loading branch information
esilvaju authored and bari12 committed Mar 8, 2024
1 parent 2a3e094 commit f723cf8
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 0 deletions.
30 changes: 30 additions & 0 deletions docs/developer/setting_up_mac_apple_silicon.md
@@ -0,0 +1,30 @@
---
id: setting_up_mac_apple_silicon
title: Setting up a Rucio Developer environment on Mac with Apple Silicon
---

## Setting up a Rucio Developer environment on Mac with Apple Silicon

Currently Rucio packages and containers are only available for x86_64 architeture only.

But a Mac equipped with Apple Silicon can execute code compiled for the x86_64 instruction set via a translation mechanism known as [Rosetta 2](https://support.apple.com/en-gb/guide/security/secebb113be1/web).

- To install Rosetta 2 run:

/usr/sbin/softwareupdate --install-rosetta

This will initiate the Rosetta installer, and you will need to consent to a license agreement.

Make sure that [docker desktop](https://docs.docker.com/desktop/install/mac-install/) is installed and updated.

## Docker environment

In order to force docker to run commands with platform **linux/amd64** instead of **linux/arm64** by default on macOS Apple Silicon, you have two options:

Set Docker default plataform to linux/amd64:

export DOCKER_DEFAULT_PLATFORM=linux/amd64

Or run it as part of the command a single time:

DOCKER_DEFAULT_PLATFORM=linux/amd64 docker-compose -f <docker-compose-file.yml>
1 change: 1 addition & 0 deletions website/sidebars.json
Expand Up @@ -75,6 +75,7 @@
}
],
"Developer": [
"developer/setting_up_mac_apple_silicon",
"developer/setting_up_intellij_dev_env",
"developer/setting_up_vscode_dev_env",
"contributing",
Expand Down

0 comments on commit f723cf8

Please sign in to comment.