M365 WebApps

by Ytech

📚 M365 WebApps - User Documentation

Complete guide for installing, activating, and using Microsoft Office apps on Linux.

📦 Installation

Method 1: APT Repository (Recommended)

For Debian/Ubuntu-based systems:

# Add the repository
echo "deb [trusted=yes] https://ytech.tools stable main" \\
  | sudo tee /etc/apt/sources.list.d/m365-compiled.list

# Update and install
sudo apt update
sudo apt install m365-compiled

# Install desktop launchers
m365ctl -mode install

Method 2: Download .deb Package

For manual installation, download the latest .deb package:

# Download from APT repository
wget https://ytech.tools/pool/main/m365-compiled_latest_amd64.deb

# Install
sudo dpkg -i m365-compiled_latest_amd64.deb
m365ctl -mode install

🔑 License Activation

After purchasing a license, you'll receive two files:

Activate Your License

# Create the config directory
mkdir -p ~/.config/m365_webapps

# Copy your license files
cp /path/to/license.json ~/.config/m365_webapps/
cp /path/to/license.sig ~/.config/m365_webapps/

# Verify activation
m365-pro -feature picker \\
  -license ~/.config/m365_webapps/license.json \\
  -sig ~/.config/m365_webapps/license.sig

🚀 Using M365 WebApps

Launching Applications

After installation, find these apps in your application menu:

First-Time Setup

  1. Launch any app (e.g., Microsoft Word)
  2. Sign in with your Microsoft account
  3. Start working! Your files sync via OneDrive

Command Line Launch

# Launch Word
m365-launch -app word

# Launch Excel
m365-launch -app excel

# Other apps: powerpoint, outlook, onenote, teams, onedrive

🔧 Troubleshooting

Issue: "No compatible browser"

Solution: Install a Chromium-based browser:

# Install Chrome
sudo apt install google-chrome-stable

# Or Chromium
sudo apt install chromium-browser

Issue: "License validation failed"

Check:

  1. License files are in correct location: ~/.config/m365_webapps/
  2. License hasn't expired
  3. Files weren't corrupted during download

Issue: App window doesn't open

# Kill stuck processes
pkill -f "chrome.*office"

# Try launching again
m365-launch -app word

🔄 Renewing Your License

When you receive renewal license files:

# Replace old files
cp /path/to/new/license.json ~/.config/m365_webapps/
cp /path/to/new/license.sig ~/.config/m365_webapps/

# Verify renewal
m365-pro -feature picker \\
  -license ~/.config/m365_webapps/license.json \\
  -sig ~/.config/m365_webapps/license.sig

Your device registry is preserved - no need to re-register!

❓ FAQ

Do I need a Microsoft 365 subscription?

Yes. M365 WebApps provides desktop integration for Linux, but you still need a Microsoft 365 account to access Office apps.

Can I use multiple Microsoft accounts?

Yes! Each app uses an isolated browser profile, so you can sign into different apps with different accounts.

What happens when my license expires?

Apps continue to launch, but license validation fails. Renew to continue full functionality.

🌟 Still Need Help?

Before contacting support, please check the troubleshooting section and FAQ above.

If you've tried everything, email [email protected] with: