Installing MPLAB® X IDE

64-bit Windows is required for reasonable performance using MPLAB® X IDE. MPLAB X IDE can run on a 32-bit Windows installation, but will likely experience slower performance. It is recommended to update the operating system to 64-bit Windows prior to installing MPLAB X IDE.

1

Download MPLAB® X Installer

Tool AboutInstallers
Installation
Instructions
Windows Linux Mac OSX
MPLAB® X
Integrated Development Environment

2

Run the Installer

Choose your operating system from the tabs below:

1

Run Installer

WinInstall.png
Go to the location where you downloaded the installer. Unzip the downloaded file and run the installer:
MPLABX-vX.XX-windows-installer.exe.

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

2

Setup

ClickNext >.

install1.png
Click image to enlarge.

3

License Agreement

Click theI accept the agreement radio button.

ClickNext >.

install2.png
Click image to enlarge.

4

Installation Options

By default, MPLAB® X IDE will be installed atC:\Program Files (x86)\Microchip\MPLABX orC:\Program Files\Microchip\MPLABX as of v5.45. If you would prefer a different directory, click on the folder icon to the right of the text box and select the desired installation location.

If you don't have an internet connection, selectNo Proxy. Otherwise, selectUse System Proxy Settings.

ClickNext >.

install3.png
Click image to enlarge.

5

Select Applications

If you only want to installMPLAB X IDE orMPLAB IPE, check or uncheck the appropriate boxes. Generally, you should install both programs.

Select the device families you want to be installed. Selecting only what you want makes the installation smaller. You can always run the installer again to add other device families or use the MPLAB Pack Manager to install a singledevice family pack.

ClickNext >.

install4.png
Click image to enlarge.

6

Ready to Install

ClickNext >.

install5.png
Click image to enlarge.

7

Installing

Wait until the installer has finished installing all components of the IDE.

install6.png
Click image to enlarge.

8

Permit Device Driver Installation

The USB device drivers are required to communicate with Microchip's hardware development tools.

Check theAlways trust software from Microchip Technology box to prevent this dialog from appearing in the future.

install7.png
Click image to enlarge.

9

Complete

Leave the box checked if you want to have your web browser opened to the Microchip MPLAB XC compiler download page to download a compiler for use with MPLAB X IDE.

Uncheck the box if you already have a compiler or want to download one later.

ClickFinish.

Installation is complete. There will be icons forMPLAB X IDE andMPLAB IPE on the desktop. There will also be launchers in the Windows/Start menu underAll Programs > Microchip > MPLAB X IDE.

install8.png
Click image to enlarge.

If you have already installed MPLAB X IDE, but are unable to communicate with our USB connected hardware tools, seestep 9 of the installation instructions below for a possible solution.

If you are running a 64-bit distribution without multiarch support, you may need toinstall dependencies before you can run the installer.

1

Untar and Run Installer

Navigate to the directory where you downloaded the file and extract the shell script from the .tar file by running the following command:

tar -xvf MPLABX-vX.XX-linux-installer.tar

You may need to make the file executable. If so, run the command:

chmod u+x MPLABX-vX.XX-linux-installer.sh


Then asroot or usingsudo, run the installer:

sudo ./MPLABX-vX.XX-linux-installer.sh

If you have problems running the graphical installer, you can run the installer in text mode instead by specifying "text" as the mode parameter value (where 2.XX is the installer version):
sudo ./MPLABX-vX.XX-linux-installer.sh--mode text

2

Setup

ClickNext >.

If you don't have Java or the open source IcedTea installed, the installer will run in text mode in the terminal. You don't need to install Java for MPLAB X IDE to run. A special version of Java will be installed in the mplabx directory exclusively for use by MPLAB X IDE. It will not interfere with existing Java or IcedTea installations.

Install1.png
Click image to enlarge.

3

License Agreement

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

ClickNext >.

Install2.png
Click image to enlarge.

4

Installation Directory

By default, MPLAB X will be installed at/opt/microchip/mplabx. If you would prefer a different directory, click on the folder icon to the right of the text box and select the desired installation location.

ClickNext >.

Install3.png
Click image to enlarge.

5

Ready to Install

ClickNext >.

Install4.png
Click image to enlarge.

6

Installing

Wait until the installer has finished installing all components of the IDE.

Install5.png
Click image to enlarge.

7

Reboot Advisory

ClickOK.

Install6.png
Click image to enlarge.

8

Complete

ClickFinish.

Installation is complete.
The package was installed into: /opt/microchip/mplabx
The executables reside in: /opt/microchip/mplabx/mplab_ide/bin

Install7.png
Click image to enlarge.

9

For Linux distributions that usesystemd, thesystemd-udevd unit may be setup to avoid inter-process communications via sockets for security reasons. Recently Ubuntu 18.04LTS has been shipped in this way. This is a change from 17.10. Other distributions like Manjaro are also shipped with blocked inter-process communications viasystemd. MPLAB X IPE and IDE rely on thesystemd-udevd unit for plug and play. MPLAB X software hasudev rules that allow a program to run on plug-and-play notifications. This program relies on sockets to communicate with MPLAB X IDE and IPE. So, to have working plug-and-play in MPLAB X software, you need to re-enable socket communications.

You can do this by adding an override file forsystemd-udevd.

$ sudo systemctl edit systemd-udevd

This will open an editor and will create anoverride.conf file. In the override file, include the following lines:

Then re-start the service:

$ sudo systemctl daemon-reload

Finally check theoverride.conf has been loaded:

$ sudo systemctl status systemd-udevd● systemd-udevd.service - udev Kernel Device ManagerLoaded: loaded (/lib/systemd/system/systemd-udevd.service; static; vendor preset: enabled)Drop-In: /etc/systemd/system/systemd-udevd.service.d           └─override.conf

1

Run Installer

WinInstall.png
Go to the location where you downloaded the installer. Unzip the downloaded file and run the installer:MPLABX-vX.XX-osx-installer.dmg.

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

2

Setup

ClickNext >.

install1_2.png
Click image to enlarge.

3

License Agreement

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

ClickNext >.

install2_2.png
Click image to enlarge.

4

Installation Directory

By default, MPLAB® X IDE will be installed at/Applications/microchip/mplabx/. If you would prefer a different directory, click on the folder icon to the right of the text box and select the desired installation location.

If you don't have an internet connection, selectNo Proxy. Otherwise, selectUse System Proxy Settings.

ClickNext >.

install3_2.png
Click image to enlarge.

5

Select Programs

If you only want to installMPLAB X IDE (Integrated Development Environment) orMPLAB IPE (Integrated Programming Environment), check/uncheck the appropriate boxes. Generally, you should install both programs.

Select the device families you want installed. Selecting only what you want makes the install smaller. You can always run the installer again to add other device families or use the MPLAB Pack Manager to install a singledevice family pack.

ClickNext >.

install4_2.png
Click image to enlarge.

6

Ready to Install

ClickNext >.

install5_2.png
Click image to enlarge.

7

Installing

Wait until the installer has finished installing all components of the IDE.

install6_2.png
Click image to enlarge.

8

Complete

Leave the box checked if you want to have your web browser opened to the Microchip MPLAB XC compiler download page to download a compiler for use with MPLAB X IDE.

Uncheck the box if you already have a compiler or want to download one later.

ClickFinish.

Installation is complete. There will be icons forMPLAB X IDE andMPLAB IPE in theApplications>microchip>mplabx>v5.xx folder

install8_2.png
Click image to enlarge.