Installing MPLAB® XC32/XC32++ Compiler

Last modified by Microchip on 2023/11/09 09:12

Download MPLAB® XC32 Installer

MPLAB® XC32 Compiler for your operating system.  The compiler downloads are about halfway down the page.

Download the installer appropriate to your operating system.

Run Installer for Windows

Go to the location where you downloaded the installer. Unzip the downloaded file and run the installer:

Depending on your Windows security settings, you may get a window asking if you are sure you want to run this program.

Answer Yes.

Run Installer for Linux

You may need to make the file executable. In a terminal, go to the directory where you downloaded the installer and run the command:​

chmod u+x

Then as root or using sudo, run the installer:

sudo ./

Run Installer for Mac

Go to the location where you downloaded the installer. Double-click on the downloaded file to unpack it and run the installer:

You may get a warning message window. You can click on Open to continue.

warning message about running downloaded files

Your computer's login and password need to be entered if you have enabled that protection for new installations. If you don't have a password enabled you can just click on OK to continue.

username and password window

All the rest of the steps are the same for all three operating systems 

Welcome to the installer

Click Next >

XC32 Setup Wizard start
Click image to enlarge.

Accept License Agreement

Click on the radio button next to I accept the agreement.

Click Next >

XC32 Setup Wizard license agreement
Click image to enlarge.

Choose License Type

Click on the radio button next to the type of license you have purchased: Workstation or Network Client.

If you did not purchase a license, select Free.

Click Next >

XC32 Setup Wizard select license type
Click image to enlarge.

Installation Directory

Use the default installation location or choose a different one, if you prefer.

Click Next >

XC32 Setup Wizard installation directory
Click image to enlarge.

Compiler Settings

  • Apply settings to all users of this machine
    • Leave checked or uncheck if required in your environment.
  • Add xc32 to the PATH environment variable
    • Not generally required unless you plan to use XC16 from the command line (terminal or script).

Click Next >

XC32 Setup Wizard compiler settings
Click image to enlarge.

Ready to Install Compiler

Click Next >

XC32 Setup Wizard ready to install
Click image to enlarge.


Wait while the installer unpacks and installs all the files.

XC32 Setup Wizard installing
Click image to enlarge.

Licensing Information

Click Next > if you:

  • Have activated a license on a previous version of MPLAB XC32.
  • Wish to use the free version of the compiler (some optimization features disabled).

Otherwise, choose to:

  • Purchase a PRO license (to receive an activation key that will unlock the Pro optimization features).
  • Use the Pro evaluation version (reverts to the free version after 60 days).
  • Provide an activation key.

Click Next >

XC32 Setup Wizard install complete - licensing information
Click image to enlarge.

Installation Complete

Click Finish

XC32 Setup Wizard finished
Click image to enlarge.