diff --git a/en/manual/install-and-update/install-stride.md b/en/manual/install-and-update/install-stride.md
index d90dae7fb..078df5610 100644
--- a/en/manual/install-and-update/install-stride.md
+++ b/en/manual/install-and-update/install-stride.md
@@ -6,6 +6,9 @@ If you want to **create games using Stride**, this guide provides the installati
If you're interested in **building the Stride engine from source** or **contributing to its development**, please visit the [Stride GitHub repository](https://github.com/stride3d/stride) for instructions on how to build from source and contribute to the project.
+> [!NOTE]
+> This guide is for **Windows users only**. For Linux instructions, visit [Install the editor using Wine](../platforms/linux/install-the-editor-using-wine.md).
+
## Installation steps
1. Download the Stride Installer from the [Stride website](http://stride3d.net/download/).
diff --git a/en/manual/install-and-update/media/stride-wine-error.webp b/en/manual/install-and-update/media/stride-wine-error.webp
new file mode 100644
index 000000000..a83d775cd
--- /dev/null
+++ b/en/manual/install-and-update/media/stride-wine-error.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:845872357995f96f18fb2ecb4593e15c72f99a981eca89c587634b0058aeba1f
+size 187770
diff --git a/en/manual/platforms/index.md b/en/manual/platforms/index.md
index bfb8c1c09..91f2a6da0 100644
--- a/en/manual/platforms/index.md
+++ b/en/manual/platforms/index.md
@@ -9,21 +9,23 @@ Stride is a cross-platform engine, which means that you can create a single game
| Name | Overall status | Editor | Building (without the editor) | [Code-only](https://stride3d.github.io/stride-community-toolkit/manual/code-only/index.html) |
| :-- | :-- | :-: | :-: | :-: |
| [Windows](windows/index.md) 10, 11 | Full support | 🟩 | 🟩 | 🟩 |
-| [Linux](linux/index.md) | Partial support, read more [here](linux/index.md#development-support) | 🟥 | 🟩 | 🟩 |
+| [Linux](linux/index.md) | Partial support, read more [here](linux/index.md#development-support) | 🟨* | 🟩 | 🟩 |
| [MacOS](macos/index.md) | Partial support, read more [here](macos/index.md#development-support) | 🟥 | 🟩 | 🟩 |
+* Despite not supporting Linux, it is possible to run the editor using a compatibility layer. See [Install the editor using Wine](linux/install-the-editor-using-wine.md).
+
> [!NOTE]
-> **Game Studio** (the editor) is being rewritten to be cross-platform. Currently however, it's not possible to use it outside of **Windows**.
+> **Game Studio** (the editor) is being rewritten to be cross-platform. Currently however, it's not possible to use it natively outside of **Windows**.
## Supported target platforms
* [Windows](windows/index.md) 10, 11
* [Linux](linux/index.md)
-* [MacOS](macos/index.md)*
-* [Android](android/index.md)*
-* [iOS](ios/index.md)*
+* [MacOS](macos/index.md)*
+* [Android](android/index.md)*
+* [iOS](ios/index.md)*
-\* There are some things to keep in mind when targeting this platform. For more information, visit its dedicated page.
+* There are some things to keep in mind when targeting this platform. For more information, visit its dedicated page.
## Platform specific code
@@ -48,6 +50,7 @@ if (Platform.Type == PlatformType.Android)
* [Xbox Live](uwp/xbox-live.md)
* [Linux](linux/index.md)
* [Setup and requirements](linux/setup-and-requirements.md)
+ * [Install the editor using Wine](linux/install-the-editor-using-wine.md)
* [MacOS](macos/index.md)
* [Android](android/index.md)
* [iOS](ios/index.md)
diff --git a/en/manual/platforms/linux/index.md b/en/manual/platforms/linux/index.md
index ed3fafb4a..a7cdd2c6e 100644
--- a/en/manual/platforms/linux/index.md
+++ b/en/manual/platforms/linux/index.md
@@ -6,9 +6,12 @@ It is possible to run games built for Windows on Linux using **compatibility lay
## Development support
-Currently, developing games on Linux is only **partially supported**. It's not possible to run **Game Studio** (the editor) on Linux, even when using a compatibility layer, such as Wine.
+Currently, developing games on Linux is only **partially supported**. **Game Studio** (the editor) remains Windows-exclusive, however starting with `4.4.0-beta5`, it is now possible to use it through a compatibility layer. For more information, check out [Install the editor using Wine](install-the-editor-using-wine.md).
-However, it is still possible to code and build games natively, meaning that when in a team, some programmers could work on a project using Linux for tasks that don't require the editor.
+> [!NOTE]
+> Using Proton/Wine to run Game Studio **is not officially supported!** You may experience problems with stability, graphical glitches and errors.
+
+Despite Game Studio not being officially available, it is still possible to code and build games natively, meaning that when in a team, some programmers could work on a project using Linux for tasks that don't require the editor.
[!INCLUDE [xplat-editor-notice](../../../includes/xplat-editor-notice.md)]
@@ -29,3 +32,4 @@ Currently, **games made with Stride can only run using the X windowing system**,
## In this section
* [Setup and requirements](setup-and-requirements.md)
+* [Install the editor using Wine](install-the-editor-using-wine.md)
diff --git a/en/manual/platforms/linux/install-stride-wine.md b/en/manual/platforms/linux/install-stride-wine.md
new file mode 100644
index 000000000..6d9445672
--- /dev/null
+++ b/en/manual/platforms/linux/install-stride-wine.md
@@ -0,0 +1,103 @@
+# Install Stride (Wine)
+
+Intermediate
+
+> [!IMPORTANT]
+> While Stride Engine offers support for running game projects on Linux (runtime), GameStudio is a WPF application that is currently only officially supported on Windows. The experience when running it via Wine may vary, and the performance, stability and functionality of the emulated application **are not guaranteed.**
+
+
+This guide outlines a robust process for setting up the Stride development environment on Linux, utilizing Wine to run the Windows-based game editor - GameStudio.
+
+
+# Prerequisites and Preparation
+
+Before getting started, ensure your Linux system is ready.
+
+1. **Install Wine:** Ensure Wine is properly installed on your Linux distribution. We'll need it to launch the [GameStudio](../game-studio/index.md) app.
+2. **Install .NET 10 SDK for Linux:** Download and install the latest Long-Term Support (LTS) version of .NET (currently .NET 10). See [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux?WT.mc_id=dotnet-35129-website) for more information.
+3. **Install Stride.CLI:** This tool allows you to download Stride NuGet packages on any operating system.
+```bash
+ dotnet tool install --global Stride.Cli;
+ stride sdk install --prerelease; # Installs the latest Stride nuget packages (at least 4.4.0-beta5 is required)
+```
+Once Stride.CLI is fully installed, you'll be able to create and run your games **from the terminal**.
+
+## Install Stride.Launcher using Wine
+
+We will install the necessary components within a specific Wine prefix to keep the environment organized.
+
+1. Download the Stride Installer from the [Stride website](http://stride3d.net/download/) and use Wine to install `StrideSetup.exe` into your designated Wine prefix.
+```bash
+ wine StrideSetup.exe
+```
+
+2. **Install the latest LTS .NET SDK for [Windows](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-10.0.400-windows-x64-installer):** Crucially, the .NET 10 SDK must be installed within the **exact same Wine prefix** that the `Stride.Launcher.exe` is using.
+```bash
+ wine
+```
+
+## Resolve NuGet-related Certificate Errors
+
+> [!IMPORTANT]
+>
+> Due to unknown package validation, the initial installation of Stride components via the launcher is almost guaranteed to fail with an "unknown NuGet CA certificate validation error."
+> 
+
+
+The following steps are the necessary manual workaround to force the required dependencies into the Wine environment.
+
+
+### Download Required Packages
+
+1. On your native Linux machine, create a new Console Application.
+2. Add the following packages to the project's .csproj file:
+ *(Note: These packages are required to satisfy the dependencies of the Stride.GameStudio within the Wine prefix.)*
+
+```xaml
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+3. Restore Packages by building the test application (`dotnet build`). This process forces NuGet to download all listed dependencies into your local Linux `.nuget/packages` folder.
+
+### Link Packages into Wine
+
+Symbolic links allows the Wine application to access the packages directly from your Linux system without having to duplicate massive directories. Imagine this as an advanced shortcut for accessing files.
+
+1. Navigate to the expected NuGet location within your Wine prefix and remove the existing `.nuget/packages` directory (if it exists and is empty, this is safe).
+
+2. Run the following command in your Linux terminal, ensuring the source path (your actual cache) is the target of the link, and the Wine path is where the link is placed
+```bash
+ln -s ~/.nuget/packages ~/.wine/drive_c/users//.nuget/packages
+```
+
+
+After this process is complete, try to open the Stride.Launcher.exe via Wine. The launcher should now be able to resolve dependencies locally within the prefix and the Stride components should appear and be runnable.
diff --git a/en/manual/platforms/linux/install-the-editor-using-wine.md b/en/manual/platforms/linux/install-the-editor-using-wine.md
new file mode 100644
index 000000000..83684a1ad
--- /dev/null
+++ b/en/manual/platforms/linux/install-the-editor-using-wine.md
@@ -0,0 +1,228 @@
+# Install the editor using Wine
+
+Intermediate
+
+Even though you can compile and run Stride games on Linux, the editor remains Windows-exclusive, due to using WPF as its UI framework. However, starting with version `4.4.0-beta5`, it is now possible to use the editor on Linux using a compatibility layer, such as Proton.
+
+> [!NOTE]
+> The editor is being rewritten to be cross-platform.
+
+> [!WARNING]
+> Running **Game Studio** through a compatibility layer is **not supported!** Expect to run into issues along the way.
+
+## Limitations
+
+* You may experience **graphical glitches** in the editor.
+* An **update** to the engine **may break your setup**.
+* **Building from the editor doesn't work.** You will have to test your game by building it natively.
+* The command `stride studio` won't be able to open the editor.
+
+## Preamble
+
+Although it is possible to run **Game Studio** using **Wine**, the experience is far better on **Proton**. In this guide, we will be using `ge-proton11-5` which is the latest version of **GE-Proton** as of writing.
+
+Additionally, this guide will provide **detailed instructions for [Bottles](https://usebottles.com/)** — a Wine/Proton manager. If you wish to use a **different application** such as [UMU Launcher](https://github.com/Open-Wine-Components/umu-launcher) or [Heroic Game's Launcher](https://heroicgameslauncher.com/), **the general steps should still apply**.
+
+## Prerequisites and preparation
+
+Before getting started, ensure your Linux system is ready.
+
+1. **Install *Bottles*.** You can download it from [flathub](https://flathub.org/en/apps/com.usebottles.bottles).
+2. **Install Linux prerequisetes.** To learn more, visit [Setup and requirements](setup-and-requirements.md).
+3. **Install .NET 10 SDK for Linux.** Download and install the latest Long-Term Support (LTS) version of .NET (currently .NET 10). See [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux?WT.mc_id=dotnet-35129-website) for more information.
+4. **Install Stride.CLI.** This tool will allow you to manage different versions of the engine on your Linux machine, without the use of a launcher.
+
+ ```bash
+ dotnet tool install -g stride.cli # Install the CLI tool
+ ```
+
+ For more information about the Stride CLI tool, visit [Stride CLI](../../get-started/stride-cli.md)
+
+Additionally, you will have to download a few **Windows** applications.
+
+1. **Download the .NET 10 SDK installer for Windows.** We will have to install it using the compatibility layer in order for Game Studio to work. You can get it from [this page](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-10.0.400-windows-x64-installer).
+2. **Download the Stride installer.** We only actually need it for installing Stride's Windows prerequiseties. You can get it from [the official website](http://stride3d.net/download/).
+
+## Installation steps
+
+1. **Install a Proton runner.** Open *Bottles* and install *Proton* by going to **Menu (located in the top right corner) > Preferences > Runners**. In this guide, we will be using `ge-proton11-5`, but we generally recommend sticking with the latest version.
+
+ 
+
+ > [!NOTE]
+ > You can always change the version of Proton/Wine later.
+
+2. **Create a new prefix.** You can do this in *Bottles* by pressing the **➕ button** in the top left corner.
+
+ 
+
+ Give your bottle (prefix) a **name** and make sure to **select the correct Proton runner**.
+
+ 
+
+ After the bottle finishes being created, click it to enter it.
+
+ 
+
+3. **Run the .NET 10 SDK installer for Windows using Proton.** In *Bottles*, click **▶️ Run Executable...** and select the `.exe` file for the SDK installer. If you missed this step in [prerequiseties](#prerequisites-and-preparation), you can get the installer from [this page](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/sdk-10.0.400-windows-x64-installer).
+
+ 
+
+ Follow the on-screen instructions to complete the installation.
+
+ 
+
+4. **Run the Stride installer.** In *Bottles*, click **▶️ Run Executable...** and select the `StrideSetup.exe` file. If you missed this step in [prerequiseties](#prerequisites-and-preparation), you can get the installer from [this page](http://stride3d.net/download/).
+
+ 
+
+ Follow the on-screen instructions until the installation **succeeds or crashes** (it should be okay as long as it managed to install the prerequiseties).
+
+ 
+
+5. **Install the engine on your system.** [Stride CLI](../../get-started/stride-cli.md) lets you manage installations of the engine directly through the command line. We will use it in order to download the editor application.
+
+ ```bash
+ # Install the latest version (including betas)
+ stride sdk install --prerelease
+ ```
+
+6. **Create a symlink with the system nuget cache.** The editor needs access to the nuget cache folder. In most Linux distributions, its located in `~/.nuget`.
+
+ For *Bottles*, click the button next to **Browse C:/ drive** and locate your user folder (should be in `drive_c/users/`).
+
+ 
+
+ Open the terminal in your user folder and create a symlink with the following command:
+
+ ```bash
+ ln -s ../../../path/to/system/user/folder/.nuget .nuget
+ ```
+
+ > [!WARNING]
+ > For *bottles* and all *flatpak* applications, the symlink needs to be **relative!**
+
+7. **Install required nuget packages.** We will also have to download a few packages to the cache. The easiest way of doing this is to:
+
+ * Create a new C# project
+
+ ```bash
+ dotnet new classlib -n StrideProtonFix && cd StrideProtonFix
+ ```
+
+ * Edit the `.csproj` file and add references to the packages
+
+ ```xml
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ```
+
+ * Build the project
+
+ ```bash
+ dotnet build StrideProtonFix.csproj
+ ```
+
+8. **Make sure `icu.dll` and `icuuc.dll` are using Windows versions.** While making this guide, we noticed that our prefix would try using Linux versions of the afformentioned DLLs, which would crash **Game Studio** on launch. This problem **may be exclusive to the version of Proton we were using**, so this step might not be necessary for you.
+
+ In *Bottles*, go to **Settings > Compatibility > DLL Overrides** and add `icu.dll` and `icuuc.dll` to the list. You can now set their overrides to **Native (Windows)**.
+
+ 
+
+9. **Launch Game Studio.** Finally, we can launch the editor using our prefix.
+
+ In *Bottles*, click the **➕ Add shortcuts...** button and **select the Game Studio executable** from `drive_c/users//.nuget/packages/stride.gamestudio//tools/net10.0-windows7.0/Stride.GameStudio.exe`.
+
+ > [!TIP]
+ > Change the name of the shortcut to include the engine version in order to not loose track.
+
+You should now be up-and-running. If the editor is still not working for you, go check out [Troubleshooting](#troubleshooting).
+
+## Troubleshooting
+
+As stated previously, **this way of using the engine isn't supported**, so you might run into some problems. Here are a few of them with solutions/workarounds:
+
+### There is a hidden window
+
+You might encounter this problem when using multiple displays with different scalling. As a workaround, you can **enable virtual desktop**, which will create a fake desktop environment for the window.
+
+In *Botles*, you can do this by going to **Settings > Display > Advanced Display Settings > Virtual Desktop**. This can also be adjusted per-shortcut.
+
+### `StrideSetup.exe` crashed before finishing
+
+As mentioned in the [installation steps](#installation-steps), **this shouldn't cause any issues**, as long as it managed to install the prerequiseties.
+
+### Game Studio says to install the `.NET Runtime`
+
+This might mean that either:
+* You **missed a step** during [installation](#installation-steps) and **didn't run the .NET SDK setup**.
+* You need to **run the setup for a newer version of .NET**
+* Game Studio **isn't detecting .NET due to the version of Proton/Wine** you are using.
+
+To fix this, you will have to either **re-run the Windows .NET SDK installer**, **try installing a newer version of the Windows .NET SDK** or **try changing the runner your prefix is using**.
+
+### Game Studio crashes on launch
+
+There could be a lot of reasons to why this happens, so it's better to try running Game Studio from the command line.
+
+In *Bottles*, go to **Tools > Command Line** and try launching Game Studio with the following command.
+
+```powershell
+dotnet drive_c\users\\.nuget\packages\stride.gamestudio\\tools\net10.0-windows7.0\Stride.GameStudio.dll
+```
+
+#### `Can't recognize 'dotnet' as an internal or external command`
+
+This means that your prefix doesn't have the .NET 10 runtime installer.
+
+To fix this, try re-running the **Windows .NET SDK installer** as shown in the [installation steps](#installation-steps).
+
+#### Errors related to `.dll` files
+
+This might be caused by Game Studio trying to use native Linux versions of some libraries, instead of the Windows ones. You will have to **override those DLLs and set them to explicitly use the Windows version**.
+
+In *Bottles*, go to **Settings > Compatibility > DLL Overrides** and add the broken DLLs to the list. You can now set their overrides to **Native (Windows)**.
+
+
+
+> [!NOTE]
+> Make sure to restart the terminal before trying again!
+
+#### It magically works!
+
+This means that Game Studio can't detect the .NET runtime, likely caused by the runner your prefix is using. Try changing to a different version and retry.
+
+### My problem isn't listed here
+
+In that case, you can do the following:
+* Try changing the runner your prefix is using.
+* Try asking on the [Stride discord](https://discord.gg/f6aerfE) for help — someone might have experienced the same problem.
+* Retry the guide with a fresh prefix.
diff --git a/en/manual/platforms/linux/media/bottles-add-shortcut.webp b/en/manual/platforms/linux/media/bottles-add-shortcut.webp
new file mode 100644
index 000000000..d46b79d00
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-add-shortcut.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f03e9b0860c3144cec7404a87d1b6810ff59c5078cb766798715a8db4e58f9b5
+size 8720
diff --git a/en/manual/platforms/linux/media/bottles-create-bottle-properties.webp b/en/manual/platforms/linux/media/bottles-create-bottle-properties.webp
new file mode 100644
index 000000000..a83fe9dd0
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-create-bottle-properties.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9b44acc3ed02f7d86ee3633f6b83cea4f8a967704a742fae0024ab8ce6ae0acf
+size 31822
diff --git a/en/manual/platforms/linux/media/bottles-create-bottle.webp b/en/manual/platforms/linux/media/bottles-create-bottle.webp
new file mode 100644
index 000000000..835d49ec1
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-create-bottle.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cc2ae1a5594636861a43372a06b68b056838bace7a5278c52a2cef4325242380
+size 1268
diff --git a/en/manual/platforms/linux/media/bottles-dll-overrides.webp b/en/manual/platforms/linux/media/bottles-dll-overrides.webp
new file mode 100644
index 000000000..fad14a782
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-dll-overrides.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:76932a2f8ec0b5d20f047f6bb27876793ae428b47b06c39868318927d84a5ab2
+size 36006
diff --git a/en/manual/platforms/linux/media/bottles-download-proton.webp b/en/manual/platforms/linux/media/bottles-download-proton.webp
new file mode 100644
index 000000000..a5dbbafaa
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-download-proton.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e8a628d8edcab2afb3ef1b982f64113db2b9f6a63b347cfa64c0319c3d67470c
+size 47882
diff --git a/en/manual/platforms/linux/media/bottles-enter-bottle.webp b/en/manual/platforms/linux/media/bottles-enter-bottle.webp
new file mode 100644
index 000000000..2359d2e5e
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-enter-bottle.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:00c43a25a8017453616ff58ac900927006197b213aa6662c23c9d7eb4e1574c0
+size 2636
diff --git a/en/manual/platforms/linux/media/bottles-find-user-folder.webp b/en/manual/platforms/linux/media/bottles-find-user-folder.webp
new file mode 100644
index 000000000..b965c4059
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-find-user-folder.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5127895c4d5e0480a54405c9427d59397f8092f210e6114892759c8c07107360
+size 54938
diff --git a/en/manual/platforms/linux/media/bottles-run-executable.webp b/en/manual/platforms/linux/media/bottles-run-executable.webp
new file mode 100644
index 000000000..c068e81c9
--- /dev/null
+++ b/en/manual/platforms/linux/media/bottles-run-executable.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:020c7c5aec7f2f4077cf0e8f573ff693bb5b34cd04ca20dc808e0c73d3b1bf9a
+size 25540
diff --git a/en/manual/platforms/linux/media/proton-dotnet-installer.webp b/en/manual/platforms/linux/media/proton-dotnet-installer.webp
new file mode 100644
index 000000000..ef992aa63
--- /dev/null
+++ b/en/manual/platforms/linux/media/proton-dotnet-installer.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:308cff6074507482b5d377f8007685cb5e3917d93a7bf89681a99893e5bbfcf4
+size 18372
diff --git a/en/manual/platforms/linux/media/proton-stride-installer.webp b/en/manual/platforms/linux/media/proton-stride-installer.webp
new file mode 100644
index 000000000..b64e72438
--- /dev/null
+++ b/en/manual/platforms/linux/media/proton-stride-installer.webp
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:31fd7be00b11b861ba96a405609e3cc16c7544be324252c263322842cb0a2d6b
+size 15542
diff --git a/en/manual/toc.yml b/en/manual/toc.yml
index 350fe97f5..3425d1fbc 100644
--- a/en/manual/toc.yml
+++ b/en/manual/toc.yml
@@ -499,6 +499,8 @@ items:
items:
- name: Setup and requirements
href: platforms/linux/setup-and-requirements.md
+ - name: Install the editor using Wine
+ href: platforms/linux/install-the-editor-using-wine.md
- name: MacOS
href: platforms/macos/index.md
- name: Android