diff --git a/docs/developer/setting_up_mac_apple_silicon.md b/docs/developer/setting_up_mac_apple_silicon.md
new file mode 100644
index 0000000000..3d2db39f6e
--- /dev/null
+++ b/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>
diff --git a/website/sidebars.json b/website/sidebars.json
index 964476f0b3..0ba552f2c1 100644
--- a/website/sidebars.json
+++ b/website/sidebars.json
@@ -28,6 +28,7 @@
                 "release-notes"
             ],
             "User": [
+                "user/setting_up_mac_apple_silicon",
                 "user/setting_up_the_rucio_client",
                 "user/using_the_client",
                 "user/using_the_admin_client",