Currently, there are 2 ways you can accomplish this task:
- Waydroid (preferred method)
- Wine
Along with some information on the progress of running newer versions!
If you found this gist useful, remember to share it with others!
Last active
November 19, 2025 09:38
-
-
Save techguy16/04dced474f2f2ab3171ccfe46224c640 to your computer and use it in GitHub Desktop.
Get Minecraft Education running on Ubuntu Linux!
- A computer running Linux and using Wayland
- X users can run Waydroid in Weston
- A Google Account
-
Add the Waydroid repository to your system
sudo apt install curl ca-certificates -y curl https://repo.waydro.id | sudo bash -
Install Waydroid
sudo apt install waydroid -y
-
Install GApps build of Android
sudo waydroid init -s GAPPS
-
Google Play Services Registration
Open the Waydroid Shell by typing:
sudo waydroid shell
You should see a prompt that resembles
:/ #. At that prompt, paste the following command:ANDROID_RUNTIME_ROOT=/apex/com.android.runtime ANDROID_DATA=/data ANDROID_TZDATA_ROOT=/apex/com.android.tzdata ANDROID_I18N_ROOT=/apex/com.android.i18n sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "select * from main where name = \"android_id\";"Copy the string of numbers after
android|, then typeexitinto the Waydroid shell.Paste the copied string of numbers into the textbox of the following website, and then press Register: https://www.google.com/android/uncertified Note: You will need to be logged in for this to work
Open the terminal again, and then type:
sudo waydroid session stop
Then open Waydroid again.
-
Log in to Google Play
Once Waydroid has booted again, open Google Play and sign in like you would on an Android phone. Ignore the on-screen keyboard for now.
-
Download and Install Minecraft Education
Once you have logged in to Google Play, search for
Minecraft Educationorcom.mojang.minecraftedu. Select the first option, and click install. -
Open Minecraft Education
Once it has installed, go to your apps launcher and find
Minecraft Education. Then click it. It should open in the Waydroid environment, and ready to sign in.
If you prefer running Minecraft Education in a window instead of the Waydroid shell, you can run the following command from your terminal while Waydroid is running:
waydroid prop set persist.waydroid.multi_windows trueIf you dislike the on-screen keyboard popping up, follow the steps outlined below:
- Open Settings in the Waydroid Shell
- Find the
Systemcategory and click it - Find
Languages & inputand click it - Click
Physical keyboard - Disable the
Use on-screen keyboardsetting
- Waydroid's docs
Microsoft decided to change the way users log in in Minecraft Education (but they didn't for Bedrock, why?), which uses the Microsoft.Identity.Client.*.dll libraries, which Wine does not support.
This issue affects the following versions:
| Version | Status |
|---|---|
| 1.18.45 | Not affected. Works as intended. |
| 1.19.51/52 | Affected. Opens to the login page, where the login window is a blank, unclosable window. |
| 1.19.53 | Affected. Window behaves the same as 1.19.51/52, but is the correct size. |
| 1.20.12 | Affected. Window behaves the same as 1.19.53, but with a close button |
| 1.20.13 | Affected. Same as 1.20.12. The login window displays 4 or 5 Chinese characters. |
| 1.21.05/1.21.06 | Doesn't even launch. |
| 1.21.50 Preview | Loads, opens login screen but cannot complete login process, error 1001. |
- A 64-bit Computer running Ubuntu Bionic, Focal, Jammy or Noble (or their Linux Mint/Pop!_OS counterparts)
- Minecraft Education (Extracted from the installer)
- Visual C++ Redist 2017, x86
Microsoft Data Access Components 2.8 SDK(No longer needed)- dxvk
- Wine Stable (used to be Staging, but Staging breaks MCEE now) + winbind (See steps on how to install)
-
Ubuntu:
sudo dpkg --add-architecture i386 sudo mkdir -pm755 /etc/apt/keyrings sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/$(lsb_release -cs)/winehq-$(lsb_release -cs).sources sudo apt update
(Linux Mint users will need to replace
$(lsb_release -cs)with the version of Ubuntu their version is based on, for example: 20.2 Uma ->focal) -
Install Wine Stable using the following command
sudo apt install winehq-stable wine-stable wine-stable-i386 wine-stable-amd64 winbind
-
Type
winecfgto open Wine's configuration. If any dialogs pop up saying that something needs installing, press 'Install'. Oncewinecfghas opened, select the drop down box labeled 'Windows Version: ' and select Windows 7 (1.18.45 and earlier) or Windows 10 (1.19.50 and above). -
To install dxvk, run the following commands:
wget https://github.com/doitsujin/dxvk/releases/download/v2.6.2/dxvk-2.6.2.tar.gz tar -zxvf dxvk-*.tar.gz mv dxvk-*/x32/* $WINEPREFIX/drive_c/?indows/syswow64 mv dxvk-*/x64/* $WINEPREFIX/drive_c/?indows/system32 rm -r dxvk-*
-
Type
unzip ME-1.18.45-Extracted.zipto extract the files. -
Open your file manager and right click on each executable and open it with Wine Windows Program Loader
-
Navigate to the 'ME-1.18.45-Extracted' directory using
cd ME-1.18.45-ExtractedThen launch Minecraft Education using
wine Minecraft.Windows.exe
- WineHQ Community
- Unix StackExchange
Author
Is there any future plans for support on GNU+Linux
@TheLizardMarkZuckerberg Sadly, no, unless any of these happens:
- Microsoft decides to revert the login system changes back to the one used in 1.18.
- Wine starts including the libraries (a stub would probably work fine)
- Someone can somehow modify MCPELauncher to run MCEE
- Or (extremely unlikely), MCEE will start supporting Linux
(Honestly, the last option will never probably happen, but how hard is it to port an app from macOS, which is another UNIX-like operating system)
Porting command-line apps from macOS to Linux is relatively easy as they share common libraries, however macOS graphics are completely different and proprietary.
Author
Porting command-line apps from macOS to Linux is relatively easy as they share common libraries, however macOS graphics are completely different and proprietary.
MCEE uses OpenGL (through RenderDragon) on non-Windows devices to display graphics. It also uses .NET, which can run on Linux (albeit without the "cool" stuff).
The problem here is, not that a port is possible, but that Microsoft (probably) thinks a Linux port would be useless and unnecessary, due to the smaller user base and not many people using it. The whole problem could be solved just by switching back to the pre-1.19 login system, which the Minecraft Launcher AND standard Bedrock edition use.
Author
@TheLizardMarkZuckerberg @CyrilSLi I can confirm Minecraft Education works in Waydroid (although it's annoying to get working)!
I was able to get MCEE 1.14.70 (I needed that specific version) running on Fedora with wine-staging. I used the latest version of Visual C++ as it is backwards compatible. I also had to install dxvk for graphics to work properly (note that on Fedora it needs to be installed from source as the repo version expects regular wine). Follow the readme to set it up in winecfg. I had gotten an "out of storage" error in MC when I loaded many chunks, may test this further if I have time.
Author
I was able to get MCEE 1.14.70 (I needed that specific version) running on Fedora with wine-staging. I used the latest version of Visual C++ as it is backwards compatible. I also had to install dxvk for graphics to work properly (note that on Fedora it needs to be installed from source as the repo version expects regular wine). Follow the readme to set it up in winecfg. I had gotten an "out of storage" error in MC when I loaded many chunks, may test this further if I have time.
I am aware that MCEE prior to the login system change in 1.19* work in Wine. For some reason, 1.18.45 used to work, but now it doesn't. 1.21.* have become full UWP apps, and no window launches in Wine anymore.
Has anyone also had a trouble logging in and knows how to solve it?
I found a tutorial that allows you to get past the sign-in dialog even on the latest versions and also allows for ray-tracing support: https://www.youtube.com/watch?v=so1VszRPOfk
The bypass method is a bit outdated and will break many textures, so you can do the following:
- Extract the
education.zipfile from the description - Copy the files
education/textures/{1,2,3,4}.pngandeducation/ui/{ui,debug}_screen.jsonto the extracted appx directory in their respective directories underdata/resource_packs/education - Edit the
data/resource_packs/education/ui/_ui_defs.jsonto include theui_screen.json file:
18c18,19
< "ui/multiplayer_lesson_screen.json"
---
> "ui/multiplayer_lesson_screen.json",
> "ui/ui_screen.json"- Edit the
data/resource_packs/education/contents.jsonfile to include the new textures and UI json files:
129a130,141
> "path": "textures/1.png"
> },
> {
> "path": "textures/2.png"
> },
> {
> "path": "textures/3.png"
> },
> {
> "path": "textures/4.png"
> },
> {
583a596,601
> },
> {
> "path": "ui/debug_screen.json"
> },
> {
> "path": "ui/ui_screen.json"- Follow the rest of the video for the setup. RTX is supported on any GCN 1.0 or later AMD GPU, however the performance is best when RT is natively supported. If you don't want RTX or don't have the hardware required, you can just run
wine Minecraft.Windows.exeto start (I had to switch to the wine-staging 10.10-1 package on arch (cachyos), as the normal wine package just showed the panorama when I launched)
Author
Has anyone also had a trouble logging in and knows how to solve it?
Login used to work in Wine 7.16, so I don't know why it doesn't work now.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Is there any future plans for support on GNU+Linux