MacOS FAQ

The Rocket.Chat Docker image (version 6.7.0 and later) is designed for the amd64 architecture, which is incompatible with the arm64 architecture used by Apple silicon Macs. Attempting to deploy the Docker image on an M-series Mac can result in compatibility issues. As a result, we recommend the following:

How do I deploy Rocket.Chat with AWS for Apple Silicon Macs (M-series)

During EC2 instance launch, choose a different operating system, such as Ubuntu, from the "Application and OS Images" (Amazon Machine Image) section.

How do I deploy Rocket.Chat on Apple Silicon Macs (M-series)

It is likely to get this error:

The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested

Follow the steps below to resolve it:

  1. Ensure you have Rosetta 2 on your Mac; this allows the M-series Macs to run Intel-based applications. Confirm this by running:

    arch -x86_64 uname -m

    If Rosetta 2 is installed, this command will output “x86_64.” If not, macOS will prompt you to install Rosetta 2.

  2. Open Docker Desktop, navigate to Settings > General and enable Rosetta for Docker Desktop. This allows Docker to emulate x86_64/amd64 architecture.

  3. In the compose.yml file, add “platform: linux/amd64” to the rocketchat service.

  4. Next, add “EXPERIMENTAL_DOCKER_DESKTOP_FORCE_QEMU: 1” to the mongodb service environment. This forces the service to use the correct emulation settings.

  5. Now, run docker compose up -d

Your Rocket.Chat instance should now be accessible via http://localhost:3000.