Install Mono on Windows

Mono runs on Windows, this page describes the various features available for users who want to use Mono on Windows as well as using Mono-based technologies on Windows without Mono (like Gtk#).

Installing Mono on Windows

  1. Download the latest Windows installer from the Downloads
  2. Run the downloaded executable as administrator. During the installation, you will be asked to accept the terms of the license, presented with an information page, and then asked to answer a few standard questions, including:
    1. What directory to install Mono to
    2. What optional components to install
    3. What Start Menu Folder to install to
    4. What port will XSP (Mono’s web server) use

The default installation will create a new “Mono for Windows” program group under the Start menu with links to all of the common tools you will need to get started with Mono

Mono Experimental Installer for Windows

In addition to the standard installer of Mono on Windows, there is an experimental installer that contains the latest experiments in integrating Mono into Windows.

See Mono Experimental Installer for Windows for more details.

Using Mono on Windows

The combined installer creates a “Mono Command Prompt” shortcut under the main Mono program group which starts a command shell with mono-relevant path information already configured. WinMonoCmdStart.png

To test the mcs compiler and the mono runtime, launch this command prompt, from there create a simple C# file:

C:\> echo class X { static void Main () { System.Console.Write("OK");} } > x.cs

Now you can compile the resulting “x.cs” file into an executable, with the Mono C# compiler:

C:\> mcs x.cs

The resulting executable (x.exe) will work with both Mono and the Microsoft runtime, to try it with Mono do:

C:\> mono x.exe

To try it with Windows do:

C:\> x.exe

If you get this far, you have a working Mono installation.


Gtk# is included as part of the Mono installation, this will allow you to create Gtk# applications on Windows with the Mono runtime which you can later deploy into Linux. See the Gtk# page for more details about the toolkit, or go directly to the Monkeyguide to check the Gtk# beginner’s guide.

The combined installer creates an “Applications” folder under the main Mono program group with two sample Gtk# applications which can be run to test your Gtk# installation.


These are:

  • Prj2Make# GTK - This is a graphical interface to the prj2make library which can be used to generate Makefiles from Visual Studio.NET C# projects and solutions. You can find out more about this application in the article Working with Mono and Visual Studio.
  • Sql# GTK - A Graphical “Query Analyzer” style tool which supports several different databases.

Alternatively, if you only want to use Gtk# on Windows, without Mono, you can use the Gtk# installer for the .NET Framework.

ASP.NET with Mono: xsp & xsp2

The combined installer also creates an “XSP” folder under the main Mono program group with links to run XSP and XSP2, the Mono ASP.NET and ASP.NET 2.0 Web Servers.


To test XSP, simply start the Web Server with:

  • The “XSP Test Web Server” or “XSP 2.0 Test Web Server” shortcut, and browse to the server using
  • The corresponding “XSP Index Page” or “XSP 2.0 Index Page” shortcut.

Contents of the Mono Packages for Windows

The Mono packages for Windows, include the following Mono packages:

  • Gtk# 1.0
  • Gtk# 2.0
  • sql#
  • prj2make
  • XSP
  • mono
  • mcs

as well as the following dependencies:

  • GTK+ 2.4.14
  • Glib 2.4
  • Gda 2.4
  • Pango 2.4
  • glade 2 and libglade
  • libArt
  • libjpeg
  • libtiff
  • libpng
  • pkg-config