Get Microsoft Office running on Linux via Wine
Microsoft 365 (click-to-run Office) famously does not work on stock Wine. Task: Microsoft 365 (click-to-run Office) famously does not work on stock Wine. This flake is a best-effort attempt to run it through umu-launcher with GE-Proton (the Wine build that Valve/GloriousEggroll ship for games) instead, with the Bottles project's ProtoSoda Wine core available as a second runner. It packages nothing from Microsoft: the Office Deployment Tool and Office itself are downloaded at install time by the ms365 script. You need a Microsoft 365 licence to sign in. Where the recipe comes from A February 2026 report in the Bottles tracker of Office 365 x64 running on Wine 10.20 with corefonts msxml6 riched20 gdiplus, the Office Deployment Tool and a couple of DLL copies. The classic ruados / eylenburg Office-on-Wine notes (Direct2D registry tweak, copying the AppvIsvSubsystems* and C2R* DLLs next to the Office binaries). The September 2026 Bottles announcement that Microsoft 365 installs, signs in (with 2FA) and runs Word on their Soda 11 Wine core in a Windows 10 prefix. GE-Proton 11 is the same Wine 11 bleeding-edge lineage, and ProtoSoda is that Soda core in Proton layout, so both are offered. Usage Or install it: nix profile install .#ms365 gives you ms365, ms365-word, ms365-excel, ... plus .desktop entries. The install downloads several GB into ~/.local/share/ms365/odt/Office and then runs the click-to-run installer inside the prefix. Leave the installer window alone; it looks frozen for long stretches. Optional: Office Home 2024 (retail key) Microsoft 365 stays the default (nix run ., .#word, packages.default). The flake also packages the one-time-purchase Office Home 2024 as a separate, opt-in output, .#office2024: the same launcher with the Home2024Retail product (Current channel), its own commands and its own prefix in ~/.local/share/office2024, so the two can be installed side by side. Home 2024 is Word, Excel, PowerPoint and OneNote. nix profile install .#office2024 gives office2024, office2024-word, ... and "Microsoft Word 2024 (Proton)" style desktop entries. Every MS365_* knob below applies too. Desktop integration without nix profile (KDE Plasma, GNOME, SteamOS desktop mode, ...): nix run .#shortcuts adds menu entries and Desktop shortcuts with the apps' own icons (taken from the installed Office) and makes Word, Excel and PowerPoint the default apps for .docx, .xlsx and .pptx. nix run .#shortcuts -- --help lists the options (--no-desktop, --no-defaults, --variant ms365, --uninstall, which removes all of it and leaves Office installed). Run it again after a git pull. Activation: redeem the key at https://setup.office.com first, which attaches the licence to your Microsoft account. Do not type the key into Office ("I have a product key"): entering a key goes through the Windows Software Protection Platform, which Wine does not have (the sppc/ shim refuses key installs). The product runs in the same vNext mode as Microsoft 365; at the first start Word shows "Sign in to get started", and signing in with the account the key was redeemed to activates it. Verified with a retail Home 2024 key. Office LTSC 2024 keys do not work. LTSC (ProPlus2024Volume, Standard2024Volume, and the cheap "LTSC" keys sold online) is volume licensed. It has no account-based activation: it only activates through the Windows Software Protection Platform, with a MAK key checked against Microsoft's activation servers or through a KMS host, and Wine does not implement that service (sppc/ is a minimal stand-in that stores licences and refuses key installs). Getting LTSC to activate would mean implementing enough of SPP (sppsvc and the SL* licensing APIs Office calls) for Office to install a key, activate it and then validate the licence. Pull requests for that are welcome and encouraged if you want to give it a try. OneNote works as of 2026-09-23: it starts, signs in, shows the notebook and page lists and the page, and edits save. Getting there took four fixes (all in the table below): a start-up crash in Office's App-V layer, page text drawn as black boxes, the navigation panes hidden behind a black layer (a Wayland driver fix, wayland-fix/), and OneNote's own "How do you want to start OneNote?" prompt after every unclean exit. OneNote for the web (installable as a PWA) remains an alternative on the same OneDrive notebooks.; tools: Claude Code. Human role: The original post does not say how a person stayed involved.; limitations: Prerequisites include a Nix environment, a valid Microsoft 365 subscription or retail Home 2024 key, and significant disk space for the Wine prefix. Constraints: LTSC/volume keys do not work; the installer UI may hang visually; direct key entry in Office fails. Integration uncertainty: This is a community flake, not official Microsoft support. Human approval is required for license redemption and initial setup..
Tools
Published on Agent Work Atlas:
Overview
Microsoft 365 (click-to-run Office) famously does not work on stock Wine.
Workflow
Microsoft 365 (click-to-run Office) famously does not work on stock Wine. This flake is a best-effort attempt to run it through umu-launcher with GE-Proton (the Wine build that Valve/GloriousEggroll ship for games) instead, with the Bottles project's ProtoSoda Wine core available as a second runner. It packages nothing from Microsoft: the Office Deployment Tool and Office itself are downloaded at install time by the ms365 script. You need a Microsoft 365 licence to sign in. Where the recipe comes from A February 2026 report in the Bottles tracker of Office 365 x64 running on Wine 10.20 with corefonts msxml6 riched20 gdiplus, the Office Deployment Tool and a couple of DLL copies. The classic ruados / eylenburg Office-on-Wine notes (Direct2D registry tweak, copying the AppvIsvSubsystems* and C2R* DLLs next to the Office binaries). The September 2026 Bottles announcement that Microsoft 365 installs, signs in (with 2FA) and runs Word on their Soda 11 Wine core in a Windows 10 prefix. GE-Proton 11 is the same Wine 11 bleeding-edge lineage, and ProtoSoda is that Soda core in Proton layout, so both are offered. Usage Or install it: nix profile install .#ms365 gives you ms365, ms365-word, ms365-excel, ... plus .desktop entries. The install downloads several GB into ~/.local/share/ms365/odt/Office and then runs the click-to-run installer inside the prefix. Leave the installer window alone; it looks frozen for long stretches. Optional: Office Home 2024 (retail key) Microsoft 365 stays the default (nix run ., .#word, packages.default). The flake also packages the one-time-purchase Office Home 2024 as a separate, opt-in output, .#office2024: the same launcher with the Home2024Retail product (Current channel), its own commands and its own prefix in ~/.local/share/office2024, so the two can be installed side by side. Home 2024 is Word, Excel, PowerPoint and OneNote. nix profile install .#office2024 gives office2024, office2024-word, ... and "Microsoft Word 2024 (Proton)" style desktop entries. Every MS365_* knob below applies too. Desktop integration without nix profile (KDE Plasma, GNOME, SteamOS desktop mode, ...): nix run .#shortcuts adds menu entries and Desktop shortcuts with the apps' own icons (taken from the installed Office) and makes Word, Excel and PowerPoint the default apps for .docx, .xlsx and .pptx. nix run .#shortcuts -- --help lists the options (--no-desktop, --no-defaults, --variant ms365, --uninstall, which removes all of it and leaves Office installed). Run it again after a git pull. Activation: redeem the key at https://setup.office.com first, which attaches the licence to your Microsoft account. Do not type the key into Office ("I have a product key"): entering a key goes through the Windows Software Protection Platform, which Wine does not have (the sppc/ shim refuses key installs). The product runs in the same vNext mode as Microsoft 365; at the first start Word shows "Sign in to get started", and signing in with the account the key was redeemed to activates it. Verified with a retail Home 2024 key. Office LTSC 2024 keys do not work. LTSC (ProPlus2024Volume, Standard2024Volume, and the cheap "LTSC" keys sold online) is volume licensed. It has no account-based activation: it only activates through the Windows Software Protection Platform, with a MAK key checked against Microsoft's activation servers or through a KMS host, and Wine does not implement that service (sppc/ is a minimal stand-in that stores licences and refuses key installs). Getting LTSC to activate would mean implementing enough of SPP (sppsvc and the SL* licensing APIs Office calls) for Office to install a key, activate it and then validate the licence. Pull requests for that are welcome and encouraged if you want to give it a try. OneNote works as of 2026-09-23: it starts, signs in, shows the notebook and page lists and the page, and edits save. Getting there took four fixes (all in the table below): a start-up crash in Office's App-V layer, page text drawn as black boxes, the navigation panes hidden behind a black layer (a Wayland driver fix, wayland-fix/), and OneNote's own "How do you want to start OneNote?" prompt after every unclean exit. OneNote for the web (installable as a PWA) remains an alternative on the same OneDrive notebooks.
Reported result
Actual outcomes are not measured in the source. The project claims best-effort support for Word, Excel, PowerPoint, and OneNote, with OneNote reportedly working as of September 2026 after specific fixes. Success depends on using account-based activation; volume licensed LTSC keys are stated to fail due to missing SPP implementation. No quantitative performance or stability metrics are provided.
Human role
The original post does not say how a person stayed involved.
Limitations
Prerequisites include a Nix environment, a valid Microsoft 365 subscription or retail Home 2024 key, and significant disk space for the Wine prefix. Constraints: LTSC/volume keys do not work; the installer UI may hang visually; direct key entry in Office fails. Integration uncertainty: This is a community flake, not official Microsoft support. Human approval is required for license redemption and initial setup.
Try it
I want to set up Microsoft Office on my Linux machine using the Tombert/office365_flake. My context is [replaceable: e.g., Ubuntu 24.04 with Nix installed]. I have a [replaceable: Microsoft 365 subscription / Office Home 2024 retail key]. Please guide me through installing the flake. First, check if I have Nix and git installed. Then, clone the repository [replaceable: URL] and run `nix profile install .#ms365` (or `.#office2024` if I have a retail key). Monitor the installation logs for errors. Once installed, instruct me to redeem my key at setup.office.com if applicable. Do not attempt to enter the key directly in the Office app. After setup, launch Word and verify it signs in successfully. If the installer appears frozen, wait for 10 minutes before intervening. Report the final status and any error logs. Ask me for clarification if my license type is ambiguous.
Source reports are not independently verified. Publication date is the catalog publication date, not the original article date.