From f51093b2327386c9859997265b22009da58ecaa1 Mon Sep 17 00:00:00 2001 From: TheresNoTime Date: Thu, 14 Dec 2023 11:34:15 +0000 Subject: DEVELOPERS.md: Add note on Docker Desktop Rosetta setting Add a note to disable the use of Rosetta if the user encounters a 503 error. https://phabricator.wikimedia.org/P49617 Change-Id: I8257b3767ab92d4b4ebc1201e712fe00b735bdab --- DEVELOPERS.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'DEVELOPERS.md') diff --git a/DEVELOPERS.md b/DEVELOPERS.md index c42aff3a1be8..e6f154df61fa 100644 --- a/DEVELOPERS.md +++ b/DEVELOPERS.md @@ -47,6 +47,10 @@ You'll need to have Docker installed: Running Docker from a Windows terminal and using the Windows file system will result in MediaWiki being very slow. For Windows 10 and higher, we recommend configuring Docker and Windows to use the [Windows Subsystem for Linux (WSL)](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux). Turn on WSL in your Windows settings, then run the following commands: `wsl --install -d ubuntu` and `wsl --set-version ubuntu 2`. Then go into Docker -> Settings -> General -> tick "Use the WSL 2 based engine", then go into Docker -> Settings -> Resources -> WSL Integration -> tick "Ubuntu". `git clone` the mediawiki repository into a WSL folder such as `home/yourusername/mediawiki` so that the files are inside WSL. Then you can run most of the commands in this tutorial outside of WSL, by opening PowerShell, navigating to the WSL directory with `cd \\wsl.localhost\Ubuntu\home\yourusername\mediawiki`, and executing shell commands as normal. To access WSL from PowerShell (rare but may be needed sometimes), you can use the command `ubuntu` to turn a PowerShell console into a WSL console. To navigate to WSL folders in [File Explorer](https://en.wikipedia.org/wiki/File_Explorer), show the Navigation Pane, then towards the bottom, look for "Linux" (it will be close to "This PC"). +**Mac users**: + +If you're using Docker Desktop and have the `Use Rosetta for x86/amd64 emulation on Apple Silicon` setting enabled, you may encounter an issue where loading the wiki results in a blank page or a 503 error. To resolve this, disable the setting and restart Docker Desktop. See [this page](https://phabricator.wikimedia.org/P49617) for more information. + ### 2. Download MediaWiki files Download the latest MediaWiki files to your computer. One way to download the latest alpha version of MediaWiki is to -- cgit v1.2.3