The Servo Parallel Browser Engine Project

Servo is a prototype web browser engine written in the
Rust language. It is currently developed on
64-bit macOS, 64-bit Linux, 64-bit Windows, 64-bit OpenHarmony, and Android.

Servo welcomes contribution from everyone. Check out:

• The Servo Book for documentation
• servo.org for news and guides

Coordination of Servo development happens:

• Here in the Github Issues
• On the Servo Zulip
• In video calls advertised in the Servo Project repo.

Getting started

For more detailed build instructions, see the Servo Book under [Getting the Code] and [Building Servo].

[Getting the Code]: https://book.servo.org/building/getting-the-code.html
[Building Servo]: https://book.servo.org/building/building.html

macOS

• Download and install Xcode and <code class="ra0-md-code">brew</code>.
• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• Restart your shell to make sure cargo is available
• Install the other dependencies: ./mach bootstrap
• Build servoshell: ./mach build

Linux

• Install curl:
• Arch: sudo pacman -S --needed curl
• Debian, Ubuntu: sudo apt install curl
• Fedora: sudo dnf install curl
• Gentoo: sudo emerge net-misc/curl
• Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• Restart your shell to make sure cargo is available
• Install the other dependencies: ./mach bootstrap
• Build servoshell: ./mach build

Windows

• Download <code class="ra0-md-code">uv</code>, and <code class="ra0-md-code">rustup</code>
• Be sure to select Quick install via the Visual Studio Community installer
• Ensure that <code class="ra0-md-code">winget</code> is available. It should be preinstalled on Windows 10 1809+ and Windows 11, otherwise can be <code class="ra0-md-code">manually installed</code>.
• In the Visual Studio Installer, ensure the following components are installed:
• Windows 10/11 SDK (anything >= 10.0.19041.0) (Microsoft.VisualStudio.Component.Windows{10, 11}SDK.{>=19041})
• MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) (Microsoft.VisualStudio.Component.VC.Tools.x86.x64)
• C++ ATL for latest v143 build tools (x86 & x64) (Microsoft.VisualStudio.Component.VC.ATL)
• Restart your shell to make sure cargo is available
• Install the other dependencies: .mach bootstrap
• Build servoshell: .mach build

Android

• Ensure that the following environment variables are set:
• ANDROID_SDK_ROOT
• ANDROID_NDK_ROOT: $ANDROID_SDK_ROOT/ndk/28.2.13676358/

ANDROID_SDK_ROOT can be any directory (such as ~/android-sdk).
All of the Android build dependencies will be installed there.

• Install the latest version of the [Android command-line

tools](https://developer.android.com/studio#command-tools) to
$ANDROID_SDK_ROOT/cmdline-tools/latest.

• Run the following command to install the necessary components:

  sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install 
   "build-tools;36.0.0" 
   "emulator" 
   "ndk;28.2.13676358" 
   "platform-tools" 
   "platforms;android-37" 
   "system-images;android-37;google_apis;x86_64"

• Follow the instructions above for the platform you are building on

OpenHarmony

• Follow the instructions above for the platform you are building on to prepare the environment.
• Depending on the target distribution (e.g. HarmonyOS NEXT vs pure OpenHarmony) the build configuration will differ slightly.
• Ensure that the following environment variables are set
• DEVECO_SDK_HOME (Required when targeting HarmonyOS NEXT)
• OHOS_BASE_SDK_HOME (Required when targeting OpenHarmony)
• OHOS_SDK_NATIVE (e.g. ${DEVECO_SDK_HOME}/default/openharmony/native or ${OHOS_BASE_SDK_HOME}/${API_VERSION}/native)
• SERVO_OHOS_SIGNING_CONFIG: Path to json file containing a valid signing configuration for the demo app.
• Review the detailed instructions at [Building for OpenHarmony].
• The target distribution can be modified by passing --flavor= to mach .