Skip to content

Instantly share code, notes, and snippets.

@a-magdy
Created November 21, 2025 09:40
Show Gist options
  • Select an option

  • Save a-magdy/068b2739241c1cdc6d5d60a15d68158a to your computer and use it in GitHub Desktop.

Select an option

Save a-magdy/068b2739241c1cdc6d5d60a15d68158a to your computer and use it in GitHub Desktop.
Mohaa Install Quick Guide

The Complete Guide to Medal of Honor: Allied Assault in 2025

Relive the classic World War II shooter with modern compatibility and multiplayer support!

Thanks to the OpenMohaa project, you can now experience this classic with modern compatibility, enhanced performance, and active multiplayer servers.

This comprehensive guide will walk you through everything you need to:

  • ✅ Install and run MOHAA on modern systems (Windows, Mac, Linux)
  • ✅ Set up multiplayer gaming with friends
  • ✅ Host your own dedicated server
  • ✅ Add custom maps and modifications

What You'll Need

  • Original MOHAA game files (legally purchased from GOG)
  • 30 minutes for setup
  • Basic terminal/command line familiarity (we'll guide you through it!)

For detailed technical documentation, check these folders:

📥 Part 1: Getting the Game Files

Step 1: Purchase & Download from GOG

  • Create an account on GoG and buy the original game Medal of Honor: Allied Assault War Chest
  • Go to your account => Games => Medal of Honor: Allied Assault War Chest => At the bottom of the page you can find a section named Download offline backup game installers
  • Download the game's 3 files (setup_medal_of_honor_2.0.0.21.exe, setup_medal_of_honor_2.0.0.21-1.bin, setup_medal_of_honor_2.0.0.21-2.bin)

Step 2: Install Original MOHAA

Windows users:

  • Run the .exe file to extract the game files

Mac & Linux users:

  • Install innoextract using brew install innoextract or other package managers for extracting the game files from the .exe file
  • Run innoextract setup_medal_of_honor_2.0.0.21.exe to extract the game files
  • This will create app & tmp directories. Feel free to delete the tmp directory after extraction
  • The app folder is the game directory. You can rename it to mohaa or any name you prefer

🚀 Part 2: Installing OpenMohaa

Step 3: Download OpenMohaa Release

Navigate to the releases page of OpenMohaa on GitHub. Find the latest release (as of Aug 2025, it's v0.82.1). Scroll to the Assets section at the bottom and pick the appropriate version for your system architecture.

Most probably you will need one of the following:

Download the zip file and extract the files directly into the game directory (the one you created in the previous step).

Step 4: Prepare Files for Execution

Windows users: Nothing is needed in this step.

Mac & Linux users:

  • Open the terminal and navigate to the game directory

  • Run the following commands to allow the OpenMohaa files to run:

    isMac() { [ "$(uname -s)" = "Darwin" ]; }
    
    if isMac; then
      # Remove quarantine attribute if it exists
      # xattr -rd com.apple.quarantine ./
      if xattr -p com.apple.quarantine launch_openmohaa_* omohaaded openmohaa >/dev/null 2>&1; then
        xattr -rd com.apple.quarantine launch_openmohaa_* omohaaded openmohaa
      fi
      # Make the files executable
      chmod +x launch_openmohaa_* omohaaded openmohaa
    fi

🎮 Part 3: Playing the Game

Step 5: Launch MOHAA

Now you can launch any of the following:

  • launch_openmohaa_base for the base game
  • launch_openmohaa_spearhead for the Spearhead expansion
  • launch_openmohaa_breakthrough for the Breakthrough expansion
  • omohaaded for the dedicated server (more on this in the server section)

Basic launch:

./launch_openmohaa_base

Custom resolution example:

./launch_openmohaa_base +set r_mode -1 +set r_customwidth 1920 +set r_customheight 1080

⚙️ Part 4: Configuration & Customization

Step 6: Locate Configuration Files

The OpenMohaa local configuration folder is located in the following directories:

  • Windows: C:\Users\<YourUser>\AppData\Local\openmohaa (or %APPDATA%\openmohaa)
  • Mac: ~/Library/Application\ Support/openmohaa
  • Linux: ~/.openmohaa

For now, we will customize the omconfig.cfg file to set some options, which is located in OpenMohaa's main/configs directory.

Launch the game and then exit it to generate the omconfig.cfg file, or copy the file from the repo to the same location.

Exact path to the file:

  • Windows: C:\Users\<YourUser>\AppData\Local\openmohaa\main\configs\omconfig.cfg or %APPDATA%\openmohaa\main\configs\omconfig.cfg
  • Mac: ~/Library/Application\ Support/openmohaa/main/configs/omconfig.cfg
  • Linux: ~/.openmohaa/main/configs/omconfig.cfg

Step 7: Customize Your Experience

You can customize the game by editing the omconfig.cfg file, which contains various settings for graphics, controls, and gameplay.

🗺️ Adding Custom Maps

Check out our Maps Guide for more information!

🖥️ Part 5: Server Setup (Optional)

Want to host your own server? Here's how to get started!

Public Internet Server

You can install it on a remote server and play online with friends worldwide.

Quick setup steps:

  • Make a copy of the game folder to a new directory
  • Download the OpenMohaa release for your server architecture (Linux x64 is recommended)
  • Extract the files into the new directory
  • (Optional) You can remove all music and video files from the main, mainta, and maintt directories to save space
  • Create a server_opm.cfg in the main directory (or on the server's ~/.openmohaa/main)
  • If you want to include any custom maps, you can place the .pk3 files in the main directory of the server folder (or on the server'same ~/.openmohaa/main)
  • Copy the folder to your online server using scp -r /path/to/server/folder root@<server-ip>:/server
  • SSH into the server: ssh root@<server-ip>
  • Navigate to the server folder: cd /server
  • Run the server: ./omohaaded +set com_target_game 0 +exec server_opm.cfg
  • To run the server in Docker, you can use the following simplified command: docker run --name mohaa -d --rm -it -p 12203:12203/udp -v $HOME/.openmohaa:/root/.openmohaa -v $PWD:/server -w /server debian bash -c './omohaaded +set com_target_game 0 +exec server_opm.cfg'

⚠️ Important: Remember to update your server's firewall to allow inbound traffic on ports 12203 & (12300 if you enabled GameSpy).

📖 Need more details? Check out our comprehensive server installation guide.


🤝 Community & Support

  • 🐛 Found a bug? Open an issue on GitHub
  • 💬 Questions? Join the discussion in Issues
  • 🔧 Contributing? Pull requests welcome!

🗺️ Roadmap & Future Plans

Coming Soon

  • 🐳 Enhanced Docker support for easy server deployment
  • 📦 Automated setup scripts for both local and server installation
  • 📁 Improved file organization separating game files from customization
  • 🔄 Auto-restart server on configuration changes
  • 🌐 Public file hosting for easy map downloads
  • 🔧 One-click server initialization scripts
  • 🖥️ Itermocil integration for easy terminal management

📜 License & Credits

This guide is for educational purposes. Medal of Honor: Allied Assault is owned by EA Games.

Special thanks to the OpenMohaa project team for keeping this classic alive!

@sbrzeski
Copy link

Thank you so much for the instructions. I was able to get MOH game running on my mac without Windows. Also I was able to set up the server on the mac and Ubuntu box.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment