Skip to content

Commit 1ff8a64

Browse files
authored
(DOCSP-46401) Adds install workaround for m4 chips. (#809) (#820)
* (DOCSP-46401) Adds install workaround for m4 chips. * Revises per tech review. (cherry picked from commit 75321bf)
1 parent dac8407 commit 1ff8a64

File tree

3 files changed

+20
-1
lines changed

3 files changed

+20
-1
lines changed

source/atlas-cli-deploy-docker.txt

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Create a Local |service| Deployment with Docker
4949
docker pull mongodb/mongodb-atlas-local:latest
5050

5151
.. step:: Run the Docker image.
52-
52+
5353
**Example:**
5454

5555
.. tabs::
@@ -61,13 +61,17 @@ Create a Local |service| Deployment with Docker
6161

6262
docker run -p 27017:27017 mongodb/mongodb-atlas-local
6363

64+
.. include:: /includes/fact-installation-workaround-m4chips.rst
65+
6466
.. tab:: Manually Connect with Auth
6567
:tabid: with-auth
6668

6769
.. code-block:: sh
6870

6971
docker run -e MONGODB_INITDB_ROOT_USERNAME=user -e MONGODB_INITDB_ROOT_PASSWORD=pass -p 27017:27017 mongodb/mongodb-atlas-local
7072

73+
.. include:: /includes/fact-installation-workaround-m4chips.rst
74+
7175
.. tab:: Automate Connection
7276
:tabid: automate-connection
7377

source/atlas-cli-deploy-local.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,12 @@ Create a Local Atlas Deployment
6969
Use the ``atlas deployments`` command to create a local |service|
7070
deployment.
7171

72+
.. important::
73+
74+
If your local machine runs MacOS Sequoia 15.2 with the Apple Silicon M4 chip, follow the procedure for
75+
:ref:`creating a local Atlas deployment with Docker <atlas-cli-deploy-docker>`
76+
instead of this procedure to avoid the error: ``container configuration failed``.
77+
7278
You can run this command in the following ways:
7379

7480
- **Interactive Mode (Default)**: the command prompts you for the
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
.. important::
2+
3+
If your local machine runs MacOS Sequoia 15.2 with the Apple Silicon M4 chip, add the following
4+
:abbr:`JVM (Java Virtual Machine)` parameter to the ``docker run`` command
5+
to prevent your container from crashing upon startup. For example:
6+
7+
.. code-block:: sh
8+
9+
docker run -e JAVA_TOOL_OPTIONS="-XX:UseSVE=0" -p 27017:27017 mongodb/mongodb-atlas-local

0 commit comments

Comments
 (0)